API de Conexiones

La API de Conexiones le permite listar e inspeccionar las cuentas de redes sociales conectadas (Instagram, Threads, Bluesky, Facebook Page, TikTok, YouTube) bajo su marca. Utilice esta API para recuperar los connection_id de destino y verificar los permisos antes de publicar contenido.

📌 Puntos finales

Método	Ruta	Descripción	Alcance requerido
`GET`	`/v1/brand/connections`	Listar cuentas de SNS conectadas con filtrado opcional por plataforma	`connections:read` o `*`
`GET`	`/v1/brand/connections/{connection_id}`	Recuperar detalles de la conexión y diagnósticos en vivo de autorización de publicación	`connections:read` o `*`

📋 Listar conexiones (`GET /v1/brand/connections`)

Recupere todas las cuentas de SNS conectadas bajo la marca.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
`sns_type`	`string`	Opcional	Filtrar por `instagram`, `threads`, `bluesky`, `facebook_page`, `tiktok` o `youtube`

Ejemplo de solicitud

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

Ejemplo de respuesta (`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"
    }
  ]
}

🔍 Obtener detalles de la conexión (`GET /v1/brand/connections/{connection_id}`)

Recupere los detalles de la conexión junto con diagnósticos en vivo de autorización de publicación.

Ejemplo de solicitud

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

Ejemplo de respuesta (`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ódigos de estado de autorización (`publish_authorization.status`)

Estado	Significado y acción
`scope_authorized`	Totalmente autorizado. Listo para publicar.
`scope_permission_unverified`	Verificación pendiente. Se puede intentar la publicación.
`scope_permission_missing`	Faltan los alcances requeridos. Se requiere reautorización en la interfaz web.
`scope_review_disabled`	Bloqueado por el estado de revisión de la aplicación de la plataforma o por los límites del modo de desarrollador.
`unsupported`	Operación no admitida en esta conexión.

🔗 Documentación relacionada