Établissements et comptes

Obtenir une clé API

Endpoints

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

Un établissement est une entreprise, une marque ou un lieu avec ses propres réseaux, médias et publications. Un Workspace en contient un ou plusieurs.

Comptes connectés

GET /v1/establishments/{id}/accounts liste les réseaux connectés : plateforme, identifiant, nom, avatar et statut. Sofia ne transmet jamais le jeton d’un réseau.

Connecter un réseau manquant

Créez un lien de connexion hébergé et envoyez-y le propriétaire. Le lien est valable 30 minutes ; à la fin, Sofia le ramène vers votre redirectUrl lorsqu’elle reconnaît son origine.

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"}'

Un réseau déjà connecté répond 409 account_already_connected ; un réseau que Sofia ne propose pas répond 422 platform_not_offered.