API des connexions

L’API des connexions permet de répertorier et de consulter les comptes de réseaux sociaux associés à votre marque : Instagram, Threads, Bluesky, Page Facebook, TikTok et YouTube. Utilisez-la pour obtenir les connection_id cibles et vérifier les autorisations avant de publier du contenu.

📌 Points de terminaison (Endpoints)

Méthode	Chemin	Description	Portée (Scope) requise
`GET`	`/v1/brand/connections`	Lister les comptes de réseaux sociaux connectés avec filtrage optionnel par plateforme	`connections:read` ou `*`
`GET`	`/v1/brand/connections/{connection_id}`	Récupérer les détails de connexion et les diagnostics d’autorisation en direct	`connections:read` ou `*`

📋 Lister les connexions (`GET /v1/brand/connections`)

Récupérez tous les comptes de réseaux sociaux connectés sous la marque.

Paramètres de requête (Query Parameters)

Paramètre	Type	Requis	Description
`sns_type`	`string`	Optionnel	Filtrer par `instagram`, `threads`, `bluesky`, `facebook_page`, `tiktok` ou `youtube`

Exemple de requête

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

Exemple de réponse (`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"
    }
  ]
}

🔍 Obtenir les détails de connexion (`GET /v1/brand/connections/{connection_id}`)

Récupérez les détails de connexion ainsi que les diagnostics d’autorisation de publication en direct.

Exemple de requête

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

Exemple de réponse (`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
  }
}

Codes de statut d’autorisation (`publish_authorization.status`)

Statut	Signification et action
`scope_authorized`	Entièrement autorisé. Prêt à publier.
`scope_permission_unverified`	Vérification en attente. La publication peut être tentée.
`scope_permission_missing`	Portées requises manquantes. Ré-autorisation requise dans l’interface Web.
`scope_review_disabled`	Bloqué par le statut de révision de l’application sur la plateforme ou les limites du mode développeur.
`unsupported`	Opération non prise en charge sur cette connexion.

🔗 Documentation connexe