門市與帳號

取得 API 金鑰

端點

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

門市是擁有自己網絡、媒體和帖文的一家商家、一個品牌或一個地點。一個 Workspace 包含一家或多家門市。

已連結的帳號

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。