店舗とアカウント

API キーを取得

エンドポイント

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

店舗とは、独自のネットワーク、メディア、投稿を持つ事業、ブランド、または場所のことです。Workspace には 1 つまたは複数の店舗があります。

連携済みアカウント

GET /v1/establishments/{id}/accounts は、連携済みネットワークの一覧を返します。プラットフォーム、ハンドル、名前、アバター、状態が含まれます。Sofia がネットワークのトークンを渡すことはありません。

未連携のネットワークを連携する

ホスト型の連携リンクを作成し、オーナーをそこへ誘導します。リンクの有効期間は 30 分です。完了すると、Sofia がそのオリジンを認識できる場合、ユーザーを redirectUrl に戻します。

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

すでに連携済みのネットワークは 409 account_already_connected で、Sofia が提供していないネットワークは 422 platform_not_offered で応答されます。