API Koneksi

API Koneksi memungkinkan Anda untuk mencantumkan dan memeriksa akun media sosial yang terhubung (Instagram, Threads, Bluesky, Facebook Page, TikTok, YouTube) di bawah merek Anda. Gunakan API ini untuk mengambil connection_id target dan memverifikasi izin sebelum menerbitkan konten.

📌 Titik Akhir

Metode	Jalur	Deskripsi	Cakupan yang Diperlukan
`GET`	`/v1/brand/connections`	Mencantumkan akun SNS yang terhubung dengan filter platform opsional	`connections:read` atau `*`
`GET`	`/v1/brand/connections/{connection_id}`	Mengambil detail koneksi dan diagnostik otorisasi langsung	`connections:read` atau `*`

📋 Daftar Koneksi (`GET /v1/brand/connections`)

Mengambil semua akun SNS yang terhubung di bawah merek.

Parameter Kueri

Parameter	Tipe	Diperlukan	Deskripsi
`sns_type`	`string`	Opsional	Filter berdasarkan `instagram`, `threads`, `bluesky`, `facebook_page`, `tiktok`, atau `youtube`

Contoh Permintaan

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

Contoh Respons (`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"
    }
  ]
}

🔍 Ambil Detail Koneksi (`GET /v1/brand/connections/{connection_id}`)

Mengambil detail koneksi beserta diagnostik Otorisasi Penerbitan langsung.

Contoh Permintaan

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

Contoh Respons (`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
  }
}

Kode Status Otorisasi (`publish_authorization.status`)

Status	Makna & Tindakan
`scope_authorized`	Diotorisasi sepenuhnya. Siap untuk diterbitkan.
`scope_permission_unverified`	Verifikasi tertunda. Penerbitan dapat dicoba.
`scope_permission_missing`	Cakupan yang diperlukan hilang. Otorisasi ulang diperlukan di Web UI.
`scope_review_disabled`	Diblokir oleh status peninjauan aplikasi platform atau batasan mode pengembang.
`unsupported`	Operasi tidak didukung pada koneksi ini.

🔗 Dokumentasi Terkait