Attività e account

Ottieni una chiave API

Endpoint

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

Un'attività è un'impresa, un marchio o un luogo con le proprie reti, i propri media e le proprie pubblicazioni. Un Workspace ne contiene una o più.

Account collegati

GET /v1/establishments/{id}/accounts elenca le reti collegate: piattaforma, handle, nome, avatar e stato. Sofia non consegna mai il token di una rete.

Collegare una rete mancante

Crea un link di collegamento ospitato e manda il titolare lì. Il link è valido 30 minuti; alla fine Sofia lo riporta al tuo redirectUrl quando ne riconosce l'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"}'

Una rete già collegata risponde 409 account_already_connected; una rete che Sofia non offre risponde 422 platform_not_offered.