콘텐츠로 이동
ANKK APPANKK Docs

術語表

ANKK APP 及其 API 中使用的關鍵領域術語和定義，連結至相關指南。

🏢 品牌 (Brand)

섹션 제목: “🏢 品牌 (Brand)”

主要營運工作區，包含 SNS 連線、發佈作業、團隊成員與 API 金鑰。每個 API 金鑰只會綁定至單一品牌。

🔗 SNS 連線 (SNS Connection)

섹션 제목: “🔗 SNS 連線 (SNS Connection)”

品牌與外部社群媒體帳戶之間經過身分驗證的 OAuth/憑證連結。由 connection_id 識別。

📝 內容 (Content)

섹션 제목: “📝 內容 (Content)”

發佈至特定 SNS 連線的內容單位，包含本文、媒體、標籤、排程時間與平台參數。

⚙️ 發佈任務 (Publish Job)

섹션 제목: “⚙️ 發佈任務 (Publish Job)”

追蹤內容項目傳送到目標 SNS 的非同步背景執行記錄。

📥 建立的內容 vs 收集的內容

섹션 제목: “📥 建立的內容 vs 收集的內容”
  • 建立的內容：在 ANKK APP 內發起並排程的貼文（失敗時可重試，在佇列中時可編輯）。
  • 收集的內容：從外部 SNS 帳戶同步的歷史貼文（唯讀；在 ANKK 中不可編輯或重試）。
  • 相關指南：已發佈內容

⏳ 已接受 (Accepted, HTTP 202)

섹션 제목: “⏳ 已接受 (Accepted, HTTP 202)”

表示請求已通過身分驗證、配額和有效載荷驗證，並已安全排隊。與正式上線確認 (published) 不同。

🔑 冪等金鑰 (Idempotency Key)

섹션 제목: “🔑 冪等金鑰 (Idempotency Key)”

客戶端提供的唯一權杖，可確保安全重試，而不會有在外部社群網路上產生重複貼文的風險。

⚠️ 需要重新連線 vs 需要使用者操作

섹션 제목: “⚠️ 需要重新連線 vs 需要使用者操作”
  • 需要重新連線：憑證已過期或權限被撤銷；需要 OAuth 重新驗證。
  • 需要使用者操作：需要在外部平台應用程式中直接執行的操作（例如：同意新條款）。
  • 相關指南：失敗與重試、連接 SNS

🔔 Webhook

섹션 제목: “🔔 Webhook”

任務完成後傳送到您的端點的 HMAC SHA256 簽名即時 HTTP POST 事件。