Listings APIListings API
Entrar
POST/api/v4/connected-accounts/disconnect-facebook

Desconectar uma conta do Facebook

Desconecta uma conta do Facebook Pages conectada anteriormente à sua conta da Listings API.

Requer uma chave de API. Consulte Autenticação para ver o formato do cabeçalho e a rotação de chaves.

Parâmetros

Corpo

NomeTipoObrigatórioDescrição
inputobjectobrigatórioWrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstringobrigatórioUUID of the connected Facebook account to disconnect. The whole account is disconnected.

Exemplo de requisição

Corpo pronto para colar. Substitua os IDs e valores de exemplo pelos seus.

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

Respostas

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.

Desfaz o vínculo entre uma conta conectada do Facebook Pages e sua conta da Listings API. Após a desconexão, as listagens sincronizadas por essa conta deixam de receber atualizações da Listings API, e as interações do Facebook deixam de aparecer no painel.

Estrutura da requisição. O corpo deve estar encapsulado em um objeto input cujo único campo é connectedAccountId. Esta é uma operação de tudo ou nada: toda a conta conectada é desconectada. Não há campo locationIds; ele é rejeitado pelo esquema. Para desvincular a listagem de um único local e manter a conta conectada, use o endpoint disconnect-listing.

Caso de uso: encerramento do atendimento a um cliente. Quando um cliente cancelar, desconecte a conta dele do Facebook para que a Listings API deixe de gerenciar suas páginas e nenhuma outra publicação ou resposta seja enviada em nome dele. Forneça o connectedAccountId do cliente (obtido em GET /connected-accounts) para desvincular completamente a conta.

Caso de uso: reautorizar uma conexão com falha. Se uma conexão do Facebook apresentar erros de credenciais que uma nova autenticação não consiga resolver, desconecte-a aqui e gere um novo link com o endpoint connect-facebook. success: true confirma a desconexão. Para o Google, use o endpoint disconnect-google. Observe que uma resposta success: true é retornada mesmo para um connectedAccountId desconhecido; portanto, interprete o sucesso como "a requisição foi processada", e não como prova de que uma conexão ativa foi removida; confirme o estado da conta com GET /connected-accounts se precisar de certeza.

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