/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 字段；schema 会拒绝它。如需仅解除单个地点的商家信息关联，同时保持账号连接，请改用 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" } }'