ÉtablissementsCréer un lien de connexion
Retour à Sofia

É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
POST/v1/establishments/{id}/connection-links

Cette requête agit sur votre vrai compte.

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

Autorisations

  • Authorizationstringrequis

    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

201application/json

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)

401

Le jeton est absent, inconnu, expiré ou révoqué.

402

subscription_required.

403

live_mode_required pour une application de test, ou la permission accounts:write manque.

404

Établissement hors du Workspace du jeton.

409

account_already_connected : le réseau est déjà connecté.

422

platform_not_offered : le réseau n’est pas proposé.

4XXapplication/json

Toute autre erreur, dans l’enveloppe d’erreur.