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

Ein Facebook-Konto trennen

Trennt ein zuvor verbundenes Facebook Pages-Konto von Ihrem Listings API-Konto.

Erfordert einen API-Schlüssel. Format des Headers und Schlüsselrotation finden Sie unter Authentifizierung.

Parameter

Body

NameTypErforderlichBeschreibung
inputobjecterforderlichWrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstringerforderlichUUID of the connected Facebook account to disconnect. The whole account is disconnected.

Beispielanfrage

Body zum direkten Einfügen. Ersetzen Sie Platzhalter-IDs und -Werte durch Ihre eigenen.

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

Antworten

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.

Trennt die Verbindung zwischen einem verbundenen Facebook Pages-Konto und Ihrem Listings API-Konto. Nach der Trennung erhalten Einträge, die über dieses Konto synchronisiert wurden, keine Aktualisierungen mehr von Listings API, und Facebook-Interaktionen werden nicht mehr im Dashboard angezeigt.

Anfragestruktur. Der Body muss in ein input-Objekt eingebettet sein, dessen einziges Feld connectedAccountId ist. Dieser Vorgang folgt dem Alles-oder-nichts-Prinzip: Das gesamte verbundene Konto wird getrennt. Es gibt kein Feld locationIds; es wird vom Schema abgelehnt. Um den Eintrag eines einzelnen Standorts zu trennen und das Konto weiterhin verbunden zu lassen, verwenden Sie stattdessen den disconnect-listing-Endpunkt.

Anwendungsfall: Offboarding eines ausscheidenden Kunden. Wenn ein Kunde kündigt, trennen Sie sein Facebook-Konto, damit Listings API seine Seiten nicht mehr verwaltet und keine weiteren Beiträge oder Antworten in seinem Namen veröffentlicht werden. Geben Sie den Wert für connectedAccountId des Kunden (aus GET /connected-accounts) an, um das Konto vollständig zu trennen.

Anwendungsfall: Erneute Autorisierung einer fehlerhaften Verbindung. Wenn bei einer Facebook-Verbindung Fehler mit den Zugangsdaten auftreten, die sich durch eine erneute Authentifizierung nicht beheben lassen, trennen Sie die Verbindung hier und erstellen Sie mit dem connect-facebook-Endpunkt einen neuen Link. success: true bestätigt die Trennung. Verwenden Sie für Google den disconnect-google-Endpunkt. Beachten Sie, dass auch bei einem unbekannten connectedAccountId eine success: true-Antwort zurückgegeben wird. Werten Sie einen Erfolg daher als „Die Anfrage wurde verarbeitet“ und nicht als Nachweis dafür, dass eine aktive Verbindung entfernt wurde; überprüfen Sie den Zustand des Kontos mit GET /connected-accounts, wenn Sie Gewissheit benötigen.

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