門市

建立連線連結

回傳託管連結，使用者在 Sofia 上授權網路，因此網路權杖不會到達你的應用。連結有效期 30 分鐘，僅限正式應用使用。

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

建立連線連結

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

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

建立連線連結

curl --request POST \
  --url 'https://api.sofia-post.com/api/v1/establishments/<id>/connection-links' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "platform": "tiktok",
  "redirectUrl": "https://crm.example.com/sofia/connected"
}'

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

建立一個托管的連接連結，並把擁有者帶到該連結。連結有效期為 30 分鐘；結束時，如果 Sofia 認可其來源，會把使用者帶回你的 redirectUrl。

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。

授權

Authorizationstringheader必填
你的個人金鑰或 OAuth 存取權杖，以 Bearer <token> 傳送。

路徑參數

idstring必填
門市的識別碼。

請求本文

application/json

platformstring必填
要連結的網路
允許的值： instagramfacebooktiktoklinkedinx
redirectUrlstring
最後把使用者送到的位址，僅當 Sofia 認可該來源；否則由 Sofia 頁面告知已完成

回應

託管連線連結及其過期時間。

platformstring必填
要連結的網路
urlstring必填
使用者打開以連結網路的 Sofia 頁面
expiresAtstring必填
連結等待點擊的截止時間（ISO 8601）

這個頁面對你有幫助嗎？