BetriebeEinen Verbindungslink erstellen
Zurück zu Sofia

Betriebe

Einen Verbindungslink erstellen

Liefert einen gehosteten Link, über den die Person ein Netzwerk bei Sofia autorisiert, ohne dass ein Netzwerk-Token Ihre App erreicht. 30 Min. gültig, nur live.

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

Diese Anfrage wirkt auf Ihr echtes Konto.

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

Autorisierungen

  • Authorizationstringerforderlich

    Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Pfadparameter

  • idstringerforderlich

    Kennung des Betriebs.

Body

application/json

  • platformstringerforderlich

    Das zu verbindende Netzwerk

    Zulässige Werte: instagramfacebooktiktoklinkedinx

  • redirectUrlstring

    Wohin die Person am Ende geschickt wird, wenn Sofia diesen Ursprung erkennt; sonst meldet eine Sofia-Seite, dass es erledigt ist

Antwort

201application/json

Der gehostete Verbindungslink und sein Ablauf.

  • platformstringerforderlich

    Das zu verbindende Netzwerk

  • urlstringerforderlich

    Die Sofia-Seite, die die Person öffnet, um das Netzwerk zu verbinden

  • expiresAtstringerforderlich

    Bis wann der Link auf einen Klick wartet (ISO 8601)

401

Das Token fehlt, ist unbekannt, abgelaufen oder widerrufen.

402

subscription_required.

403

live_mode_required bei einer Test-Anwendung, oder die Berechtigung accounts:write fehlt.

404

Betrieb außerhalb des Workspace des Tokens.

409

account_already_connected: Das Netzwerk ist bereits verbunden.

422

platform_not_offered: Das Netzwerk wird nicht angeboten.

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.