/api/v4/connected-accounts/disconnect-facebook中斷 Facebook 帳號連線
中斷先前已連結至您 Listings API 帳戶的 Facebook Pages 帳號連線。
參數
請求主體
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
| input | object | 必填 | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | 必填 | UUID of the connected Facebook account to disconnect. The whole account is disconnected. |
請求範例
可直接貼上的請求主體。請將預留位置 ID 與值換成您自己的。
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}回應
200Request accepted. `success: true` confirms the disconnect was processed.
{ "data": { "fbBulkDisconnect": { "success": true } }}400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.
解除已連結的 Facebook Pages 帳號與您的 Listings API 帳戶之間的連結。中斷連線後，透過該帳號同步的商家資訊將停止接收 Listings API 的更新，Facebook 互動也將停止顯示於儀表板中。
請求格式。 請求主體必須包在 input 物件中，且該物件只能包含 connectedAccountId 欄位。此操作無法只執行一部分：整個已連結帳號都會中斷連線。沒有 locationIds 欄位；結構描述會拒絕此欄位。若要解除單一地點的商家資訊連結，同時保留帳號連線，請改用 disconnect-listing 端點。
使用案例：終止離約客戶的服務。 當客戶取消服務時，請中斷其 Facebook 帳號連線，讓 Listings API 停止管理其粉絲專頁，並且不再代表客戶推送任何貼文或回覆。提供客戶的 connectedAccountId（取自 GET /connected-accounts），即可完全解除帳號連結。
使用案例：重新授權發生問題的連線。 如果 Facebook 連線有無法透過重新授權排除的憑證錯誤，請在此中斷連線，再使用 connect-facebook 端點產生新的連結。success: true 會確認連線已中斷。若是 Google，請使用 disconnect-google 端點。請注意，即使 connectedAccountId 未知，仍會傳回 success: true 回應，因此應將成功視為「請求已處理」，而非已移除有效連線的證明；如果您需要確定結果，請使用 GET /connected-accounts 確認帳號狀態。
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-facebook' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" } }'