POST/api/v4/connected-accounts/disconnect-facebook

Déconnecter un compte Facebook

Déconnecte de votre compte Listings API un compte Facebook Pages précédemment connecté.

Nécessite une clé API. Consultez Authentification pour le format de l’en-tête et la rotation des clés.

Paramètres

Corps

NomTypeObligatoireDescription
inputobjectobligatoireWrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstringobligatoireUUID of the connected Facebook account to disconnect. The whole account is disconnected.

Exemple de requête

Corps prêt à coller. Remplacez les identifiants et valeurs d’exemple par les vôtres.

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

Réponses

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.

Rompt le lien entre un compte Facebook Pages connecté et votre compte Listings API. Une fois le compte déconnecté, les fiches synchronisées par son intermédiaire ne reçoivent plus de mises à jour de Listings API et les interactions Facebook cessent d’apparaître dans le tableau de bord.

Structure de la requête. Le corps doit être encapsulé dans un objet input dont le seul champ est connectedAccountId. Cette opération s’effectue en tout ou rien : le compte connecté est déconnecté dans son intégralité. Il n’existe aucun champ locationIds ; le schéma le rejette. Pour dissocier la fiche d’un seul établissement tout en maintenant le compte connecté, utilisez plutôt l’endpoint disconnect-listing.

Cas d’utilisation : fin de service pour un client. Lorsqu’un client résilie, déconnectez son compte Facebook afin que Listings API cesse de gérer ses pages et qu’aucune nouvelle publication ni réponse ne soit envoyée en son nom. Fournissez le connectedAccountId du client (obtenu via GET /connected-accounts) pour dissocier complètement le compte.

Cas d’utilisation : réautoriser une connexion défaillante. Si une connexion Facebook présente des erreurs d’identifiants qu’une réauthentification ne permet pas de résoudre, déconnectez-la ici et générez un nouveau lien avec l’endpoint connect-facebook. success: true confirme la déconnexion. Pour Google, utilisez l’endpoint disconnect-google. Notez qu’une réponse success: true est renvoyée même pour un connectedAccountId inconnu ; considérez donc le succès comme signifiant « la requête a été traitée », et non comme la preuve qu’une connexion active a été supprimée ; vérifiez l’état du compte avec GET /connected-accounts si vous avez besoin d’une certitude.

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"    }  }'