API Kết nối

API Kết nối cho phép bạn liệt kê và kiểm tra các tài khoản mạng xã hội đã kết nối (Instagram, Threads, Bluesky, Facebook Page, TikTok, YouTube) thuộc thương hiệu của bạn. Hãy sử dụng API này để lấy các connection_id mục tiêu và xác minh các quyền trước khi xuất bản nội dung.

📌 Điểm cuối

Phương thức	Đường dẫn	Mô tả	Scope yêu cầu
`GET`	`/v1/brand/connections`	Liệt kê các tài khoản SNS đã kết nối với bộ lọc nền tảng tùy chọn	`connections:read` hoặc `*`
`GET`	`/v1/brand/connections/{connection_id}`	Lấy chi tiết kết nối và chẩn đoán ủy quyền trực tiếp	`connections:read` hoặc `*`

📋 Liệt kê kết nối (`GET /v1/brand/connections`)

Lấy tất cả các tài khoản SNS đã kết nối thuộc thương hiệu.

Tham số truy vấn

Tham số	Loại	Bắt buộc	Mô tả
`sns_type`	`string`	Tùy chọn	Lọc theo `instagram`, `threads`, `bluesky`, `facebook_page`, `tiktok`, hoặc `youtube`

Ví dụ yêu cầu

curl -X GET "https://api.ankk.app/v1/brand/connections?sns_type=instagram" \
  -H "Authorization: Bearer spk_live_xxxxxxxx"

Ví dụ phản hồi (`200 OK`)

{
  "items": [
    {
      "id": "conn_01jm8x9k2example",
      "sns_type": "instagram",
      "platform": "meta.instagram",
      "display_name": "ACME Official",
      "username": "acme_official",
      "profile_image_url": "https://example.com/profiles/acme.jpg",
      "status": "connected",
      "created_at": "2026-08-01T10:00:00Z"
    }
  ]
}

🔍 Lấy chi tiết kết nối (`GET /v1/brand/connections/{connection_id}`)

Lấy chi tiết kết nối cùng với chẩn đoán Ủy quyền Xuất bản (Publish Authorization) trực tiếp.

Ví dụ yêu cầu

curl -X GET "https://api.ankk.app/v1/brand/connections/conn_01jm8x9k2example" \
  -H "Authorization: Bearer spk_live_xxxxxxxx"

Ví dụ phản hồi (`200 OK`)

{
  "id": "conn_01jm8x9k2example",
  "sns_type": "instagram",
  "platform": "meta.instagram",
  "display_name": "ACME Official",
  "username": "acme_official",
  "profile_image_url": "https://example.com/profiles/acme.jpg",
  "status": "connected",
  "created_at": "2026-08-01T10:00:00Z",
  "publish_authorization": {
    "status": "scope_authorized",
    "required_scopes": ["instagram_business_basic", "instagram_business_content_publish"],
    "missing_scopes": [],
    "retryable": false
  }
}

Các mã trạng thái ủy quyền (`publish_authorization.status`)

Trạng thái	Ý nghĩa & Hành động
`scope_authorized`	Đã được ủy quyền đầy đủ. Sẵn sàng để xuất bản.
`scope_permission_unverified`	Đang chờ xác minh. Có thể thử xuất bản.
`scope_permission_missing`	Thiếu các scope bắt buộc. Yêu cầu ủy quyền lại trong giao diện Web.
`scope_review_disabled`	Bị chặn bởi trạng thái xét duyệt ứng dụng của nền tảng hoặc các giới hạn chế độ nhà phát triển.
`unsupported`	Hoạt động không được hỗ trợ trên kết nối này.

🔗 Tài liệu liên quan