Thuật ngữ

Các thuật ngữ và định nghĩa chuyên ngành chính được sử dụng xuyên suốt ANKK APP và các API của nó, được liên kết với các hướng dẫn liên quan.

🏢 Thương hiệu (Brand)

Đơn vị vận hành chính bao gồm các kết nối SNS, tác vụ đăng bài, thành viên nhóm và các khóa API. Mỗi khóa API được ràng buộc chặt chẽ với một thương hiệu duy nhất.

Hướng dẫn liên quan: Tạo một Thương hiệu, API Thương hiệu, Nhóm & Cài đặt

Một liên kết OAuth/thông tin xác thực giữa một thương hiệu và một tài khoản mạng xã hội bên ngoài. Được xác định bởi một connection_id.

Hướng dẫn liên quan: Kết nối tài khoản SNS, API Kết nối, Khả năng của SNS

📝 Nội dung (Content)

Một đơn vị đăng bài logic nhắm mục tiêu đến một kết nối SNS cụ thể, chứa văn bản nội dung, đa phương tiện, hashtag, thời gian lập lịch và các tham số nền tảng.

Hướng dẫn liên quan: Soạn thảo nội dung, API Nội dung

⚙️ Tác vụ đăng bài (Publish Job)

Một bản ghi thực thi nền bất đồng bộ theo dõi việc phân phối một mục nội dung đến SNS đích của nó.

Hướng dẫn liên quan: Hàng đợi & Trạng thái Đăng bài, Lỗi & Thử lại

📥 Nội dung được tạo so với Nội dung được thu thập

Nội dung được tạo (Created Content): Các bài viết bắt nguồn và được lập lịch trong ANKK APP (có thể thử lại khi thất bại, có thể chỉnh sửa khi đang trong hàng đợi).
Nội dung được thu thập (Collected Content): Các bài viết lịch sử được đồng bộ từ các tài khoản SNS bên ngoài (chỉ đọc; không thể chỉnh sửa hoặc thử lại trong ANKK).
Hướng dẫn liên quan: Nội dung đã đăng

⏳ Đã tiếp nhận (Accepted - HTTP 202)

Cho biết một yêu cầu đã vượt qua xác thực, hạn ngạch và xác thực dữ liệu và được đưa vào hàng đợi một cách an toàn. Khác với xác nhận phân phối trực tiếp (published).

Hướng dẫn liên quan: Hàng đợi & Trạng thái Đăng bài, Webhooks

🔑 Khóa Idempotency (Idempotency Key)

Một token duy nhất do client cung cấp nhằm bảo đảm việc thử lại an toàn mà không có nguy cơ tạo bài viết trùng lặp trên các mạng xã hội bên ngoài.

Hướng dẫn liên quan: Xử lý lỗi, API Nội dung

⚠️ Yêu cầu kết nối lại so với Yêu cầu hành động từ người dùng

Yêu cầu kết nối lại (Reconnect Required): Token hết hạn hoặc quyền hạn bị thu hồi; yêu cầu xác thực lại qua OAuth.
Yêu cầu hành động từ người dùng (Requires User Action): Cần hành động trực tiếp trong ứng dụng nền tảng bên ngoài (ví dụ: đồng ý với các điều khoản mới).
Hướng dẫn liên quan: Lỗi & Thử lại, Kết nối SNS

🔔 Webhook

Một sự kiện HTTP POST thời gian thực được ký bằng HMAC SHA256 được gửi đến điểm cuối của bạn khi tác vụ hoàn thành.

Hướng dẫn liên quan: Tham chiếu Webhooks