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

Disconnetti un account Facebook

Disconnette un account Facebook Pages precedentemente collegato al tuo account Listings API.

Richiede una chiave API. Consulta Autenticazione per il formato dell’header e la rotazione delle chiavi.

Parametri

Corpo

NomeTipoObbligatorioDescrizione
inputobjectobbligatorioWrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstringobbligatorioUUID of the connected Facebook account to disconnect. The whole account is disconnected.

Richiesta di esempio

Corpo pronto da incollare. Sostituisci gli ID e i valori segnaposto con i tuoi.

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

Risposte

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.

Interrompe il collegamento tra un account Facebook Pages connesso e il tuo account Listings API. Dopo la disconnessione, le schede sincronizzate tramite quell'account smettono di ricevere aggiornamenti da Listings API e le interazioni di Facebook smettono di apparire nella dashboard.

Struttura della richiesta. Il corpo deve essere racchiuso in un oggetto input il cui unico campo è connectedAccountId. Questa operazione non ammette disconnessioni parziali: viene disconnesso l'intero account collegato. Non è previsto alcun campo locationIds: lo schema lo rifiuta. Per scollegare la scheda di una singola sede mantenendo l'account connesso, usa invece l'endpoint disconnect-listing.

Caso d'uso: cessazione del servizio per un cliente. Quando un cliente disdice il servizio, disconnetti il suo account Facebook affinché Listings API smetta di gestire le sue pagine e non vengano più pubblicati post o risposte per suo conto. Fornisci il valore connectedAccountId del cliente (ottenuto da GET /connected-accounts) per scollegare completamente l'account.

Caso d'uso: nuova autorizzazione di una connessione non funzionante. Se una connessione Facebook presenta errori relativi alle credenziali che una nuova autenticazione non riesce a risolvere, disconnettila qui e genera un nuovo link con l'endpoint connect-facebook. success: true conferma la disconnessione. Per Google, usa l'endpoint disconnect-google. Tieni presente che viene restituita una risposta success: true anche per un valore connectedAccountId sconosciuto, quindi interpreta l'esito positivo come "la richiesta è stata elaborata", non come prova che sia stata rimossa una connessione attiva; verifica lo stato dell'account con GET /connected-accounts se hai bisogno di esserne certo.

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