AttivitàCreare un link di collegamento
Torna a Sofia

Attività

Creare un link di collegamento

Restituisce un link ospitato dove la persona autorizza una rete con Sofia, senza che alcun token di rete arrivi alla tua app. Valido 30 minuti; solo app live.

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

Questa richiesta agisce sul tuo account reale.

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

Autorizzazioni

  • Authorizationstringobbligatorio

    La tua chiave personale o il token di accesso OAuth, inviato come Bearer <token>.

Parametri di percorso

  • idstringobbligatorio

    Identificatore dell'attività.

Body

application/json

  • platformstringobbligatorio

    La rete da collegare

    Valori ammessi: instagramfacebooktiktoklinkedinx

  • redirectUrlstring

    Dove mandare la persona alla fine, se Sofia riconosce questa origine; altrimenti una pagina di Sofia le dice che è fatto

Risposta

201application/json

Il link di collegamento ospitato e la sua scadenza.

  • platformstringobbligatorio

    La rete da collegare

  • urlstringobbligatorio

    La pagina di Sofia che la persona apre per collegare la rete

  • expiresAtstringobbligatorio

    Fino a quando il link attende un clic (ISO 8601)

401

Il token manca, è sconosciuto, scaduto o revocato.

402

subscription_required.

403

live_mode_required per un'applicazione di test, oppure manca il permesso accounts:write.

404

Attività fuori dal Workspace del token.

409

account_already_connected: la rete è già collegata.

422

platform_not_offered: la rete non è offerta.

4XXapplication/json

Qualsiasi altro errore, nella busta di errore.