Connections-API

Die Connections-API ermöglicht es Ihnen, verbundene Social-Media-Konten (Instagram, Threads, Bluesky, Facebook-Seite, TikTok, YouTube) unter Ihrer Brand aufzulisten und zu inspizieren. Verwenden Sie diese API, um Ziel-connection_ids abzurufen und Berechtigungen vor der Veröffentlichung von Inhalten zu überprüfen.

📌 Endpunkte

Methode	Pfad	Beschreibung	Erforderlicher Scope
`GET`	`/v1/brand/connections`	Verbundene SNS-Konten mit optionaler Plattformfilterung auflisten	`connections:read` oder `*`
`GET`	`/v1/brand/connections/{connection_id}`	Verbindungsdetails und Live-Autorisierungsdiagnose abrufen	`connections:read` oder `*`

📋 Verbindungen auflisten (`GET /v1/brand/connections`)

Rufen Sie alle verbundenen SNS-Konten unter der Brand ab.

Abfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
`sns_type`	`string`	Optional	Filtern nach `instagram`, `threads`, `bluesky`, `facebook_page`, `tiktok` oder `youtube`

Anfragebeispiel

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

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

🔍 Verbindungsdetails abrufen (`GET /v1/brand/connections/{connection_id}`)

Rufen Sie Verbindungsdetails zusammen mit der Live-Diagnose zur Veröffentlichungsautorisierung ab.

Anfragebeispiel

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

Antwortbeispiel (`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
  }
}

Autorisierungs-Statuscodes (`publish_authorization.status`)

Status	Bedeutung & Aktion
`scope_authorized`	Vollständig autorisiert. Bereit zum Veröffentlichen.
`scope_permission_unverified`	Überprüfung ausstehend. Veröffentlichung kann versucht werden.
`scope_permission_missing`	Erforderliche Scopes fehlen. Erneute Autorisierung in der Web-UI erforderlich.
`scope_review_disabled`	Blockiert durch den App-Review-Status der Plattform oder Einschränkungen im Entwicklermodus.
`unsupported`	Vorgang wird für diese Verbindung nicht unterstützt.

🔗 Verwandte Dokumentation