Betriebe und Konten

API-Schlüssel erhalten

Endpoints

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

Ein Betrieb ist ein Unternehmen, eine Marke oder ein Ort mit eigenen Netzwerken, Medien und Beiträgen. Ein Workspace enthält einen oder mehrere.

Verbundene Konten

GET /v1/establishments/{id}/accounts listet die verbundenen Netzwerke auf: Plattform, Handle, Name, Avatar und Status. Sofia gibt nie das Token eines Netzwerks heraus.

Ein fehlendes Netzwerk verbinden

Erstellen Sie einen gehosteten Verbindungslink und schicken Sie den Inhaber dorthin. Der Link ist 30 Minuten gültig; am Ende führt Sofia ihn zu Ihrer redirectUrl zurück, wenn Sofia deren Herkunft erkennt.

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

Ein bereits verbundenes Netzwerk antwortet mit 409 account_already_connected; ein Netzwerk, das Sofia nicht anbietet, antwortet mit 422 platform_not_offered.