Establecimientos y cuentas

Obtener una clave de API

Endpoints

GET/v1/establishmentsGET/v1/establishments/{id}/accountsPOST/v1/establishments/{id}/connection-links

Un establecimiento es un negocio, una marca o un lugar con sus propias redes, medios y publicaciones. Un Workspace tiene uno o varios.

Cuentas conectadas

GET /v1/establishments/{id}/accounts lista las redes conectadas: plataforma, handle, nombre, avatar y estado. Sofia nunca entrega el token de una red.

Conectar una red que falta

Crea un enlace de conexión alojado y envía al propietario a él. El enlace es válido durante 30 minutos; al terminar, Sofia lo devuelve a tu redirectUrl cuando Sofia reconoce su origen.

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

Una red ya conectada responde 409 account_already_connected; una red que Sofia no ofrece responde 422 platform_not_offered.