Listings APIListings API
로그인
POST/api/v4/connected-accounts/disconnect-facebook

Facebook 계정 연결 해제

이전에 연결한 Facebook Pages 계정과 Listings API 계정의 연결을 해제합니다.

API 키가 필요합니다. 헤더 형식과 키 교체는 인증을 참고하세요.

매개변수

본문

이름유형필수설명
inputobject필수Wrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstring필수UUID of the connected Facebook account to disconnect. The whole account is disconnected.

요청 예시

바로 붙여 넣을 수 있는 본문입니다. 예시 ID와 값을 실제 값으로 바꾸세요.

Request body
{  "input": {    "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"  }}

응답

200Request accepted. `success: true` confirms the disconnect was processed.
Response
{  "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 상호작용도 대시보드에 더 이상 표시되지 않습니다.

요청 구조. 본문은 connectedAccountId만 필드로 갖는 input 객체로 감싸야 합니다. 이 작업은 계정 단위로만 처리되며, 연결된 계정 전체의 연결이 해제됩니다. locationIds 필드는 없으며, 스키마에서 허용하지 않습니다. 계정 연결은 유지하면서 단일 사업장의 등록 정보 연결만 해제하려면 disconnect-listing 엔드포인트를 사용합니다.

사용 사례: 서비스를 해지하는 고객의 이용 종료 처리. 고객이 서비스를 해지하면 해당 고객의 Facebook 계정 연결을 해제하여 Listings API가 고객의 페이지 관리를 중단하고 고객을 대신해 더 이상 게시물이나 답글을 전송하지 않도록 합니다. 계정 연결을 완전히 해제하려면 고객의 connectedAccountId(GET /connected-accounts에서 확인)를 전달합니다.

사용 사례: 문제가 발생한 연결의 권한 재승인. Facebook 연결에 재인증으로 해결할 수 없는 자격 증명 오류가 있으면 여기에서 연결을 해제하고 connect-facebook 엔드포인트로 새 링크를 발급합니다. success: true는 연결 해제를 확인합니다. Google의 경우 disconnect-google 엔드포인트를 사용합니다. 알 수 없는 connectedAccountId에 대해서도 success: true 응답이 반환되므로, 성공 응답은 실제 연결이 제거되었다는 증거가 아니라 "요청이 처리되었다"는 의미로 해석하고, 확실한 확인이 필요하면 GET /connected-accounts로 계정 상태를 확인합니다.

Request
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"    }  }'
Run in playground