Établissements

Créer un lien de connexion

Renvoie un lien hébergé où la personne autorise un réseau auprès de Sofia, sans qu’aucun jeton de réseau ne vous parvienne. Valable 30 minutes, en live.

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

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

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

Créer un lien de connexion

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

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

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.

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.

Autorisations

Authorizationstringheaderrequis
Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

Paramètres de chemin

idstringrequis
Identifiant de l’établissement.

Corps

application/json

platformstringrequis
Le réseau à connecter
Valeurs autorisées : instagramfacebooktiktoklinkedinx
redirectUrlstring
Où renvoyer la personne à la fin, si Sofia reconnaît cette origine ; sinon une page Sofia lui indique que c’est terminé

Réponse

Le lien de connexion hébergé et son expiration.

platformstringrequis
Le réseau à connecter
urlstringrequis
La page Sofia que la personne ouvre pour connecter le réseau
expiresAtstringrequis
Jusqu’à quand le lien attend un clic (ISO 8601)

Cette page vous a-t-elle aidé ?