EstablecimientosCrear un enlace de conexión
Volver a Sofia

Establecimientos

Crear un enlace de conexión

Devuelve un enlace alojado donde la persona autoriza una red con Sofia, sin que ningún token de red llegue a tu app. Válido 30 minutos; solo apps live.

POSThttps://api.sofia-post.com/api/v1/establishments/{id}/connection-links
POST/v1/establishments/{id}/connection-links

Esta petición actúa sobre tu cuenta real.

curl -X POST 'https://api.sofia-post.com/api/v1/establishments/{id}/connection-links' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"platform":"tiktok","redirectUrl":"https://crm.example.com/sofia/connected"}'

Autorizaciones

  • Authorizationstringobligatorio

    Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Parámetros de ruta

  • idstringobligatorio

    Identificador del establecimiento.

Cuerpo

application/json

  • platformstringobligatorio

    La red que conectar

    Valores permitidos: instagramfacebooktiktoklinkedinx

  • redirectUrlstring

    Adónde enviar a la persona al final, si Sofia reconoce este origen; si no, una página de Sofia le indica que ha terminado

Respuesta

201application/json

El enlace de conexión alojado y su caducidad.

  • platformstringobligatorio

    La red que conectar

  • urlstringobligatorio

    La página de Sofia que la persona abre para conectar la red

  • expiresAtstringobligatorio

    Hasta cuándo espera el enlace un clic (ISO 8601)

401

El token falta, es desconocido, ha caducado o está revocado.

402

subscription_required.

403

live_mode_required para una aplicación de prueba, o falta el permiso accounts:write.

404

Establecimiento fuera del Workspace del token.

409

account_already_connected: la red ya está conectada.

422

platform_not_offered: la red no se ofrece.

4XXapplication/json

Cualquier otro error, en el sobre de error.