Ein Facebook-Konto verbinden

Parameter

Body

Name	Typ	Erforderlich	Beschreibung
input	object	erforderlich	Wrapper object. The entire request body must be nested under `input`.
input.successUrl	string	erforderlich	URL the user is redirected to after they successfully authorize Facebook. Must be an absolute https URL you control.
input.errorUrl	string	erforderlich	URL the user is redirected to if they cancel or the authorization fails. Must be an absolute https URL you control.

Antworten

200OAuth URL generated successfully. Redirect the user to `url` to begin the Facebook authorization flow. The `url` shown is a placeholder; send the user to the `url` returned in your own response.

Response

{  "data": {    "bulkConnectLinkForFacebook": {      "errors": null,      "success": true,      "url": "https://connect.example.com/oauth?token=8f3c1d92-..."    }  }}

400Bad request, the body was not wrapped in `input`, or `successUrl`/`errorUrl` was omitted (error message: `Variable "$input" of required type "FacebookOauthBulkInput!" was not provided`).

401Unauthenticated, missing or invalid API key.

Generiert eine kurzzeitig gültige OAuth-URL, die ein Benutzer aufruft, um Listings API zur gebündelten Verwaltung seiner Facebook-Seiten zu autorisieren. Leiten Sie den Benutzer zur zurückgegebenen url weiter; während des Ablaufs prüft und akzeptiert er die Bedingungen von Facebook und erteilt die Berechtigungen zur Seitenverwaltung, die Listings API benötigt. Der Link ist 24 Stunden lang gültig.

Anfrageformat. Der Body muss in ein input-Objekt eingebettet sein, das die beiden Pflichtfelder successUrl und errorUrl enthält. Dies sind die absoluten https-URLs, zu denen der Benutzer zurückgeleitet wird, nachdem er den Facebook-Autorisierungsablauf abgeschlossen (oder abgebrochen) hat; übergeben Sie Endpunkte Ihrer eigenen Anwendung, die bei Erfolg das Onboarding fortsetzen und bei einem Fehler einen erneuten Versuch anbieten. Es gibt kein accountId-Feld, der Verbindungslink ist immer auf das Konto beschränkt, dem der API-Schlüssel gehört, und das Senden von accountId (oder eines flachen, nicht eingebetteten Bodys) wird mit HTTP 400 abgelehnt.

Dies ist das Facebook-Gegenstück zum connect-google-Endpunkt und der erste Schritt des Workflows zur gebündelten Verknüpfung. Nach der Autorisierung erscheint das Konto in GET /connected-accounts mit einem connectedAccountId, der für die Zuordnung und Synchronisierung verwendet wird.

Anwendungsfall: Onboarding der Facebook-Seiten eines Kunden. Nachdem ein Kunde Zugriff auf Facebook gewährt hat, leiten Sie ihn zur zurückgegebenen url weiter. Wenn er den Ablauf abgeschlossen hat, führen Sie POST /connected-accounts/trigger-matches aus, prüfen Sie die Ergebnisse mit GET /connected-accounts/{connectedAccountId}/connection-suggestions und bestätigen Sie die Zuordnungen über POST /connected-accounts/confirm-matches, damit die Synchronisierung der Facebook-Seitendaten mit den zugeordneten Listings API-Standorten beginnt.

Anwendungsfall: erneute Autorisierung nach abgelehnten Berechtigungen. Wenn ein Benutzer eine erforderliche Facebook-Berechtigung überspringt, ist über die Verbindung keine Synchronisierung möglich. Stellen Sie den Link erneut aus und lassen Sie den Benutzer die Autorisierung wiederholen, wobei er alle Berechtigungen erteilen muss.

Verwenden Sie für Google den connect-google-Endpunkt. success: true mit einem url, dessen Wert nicht null ist, bedeutet, dass der Link generiert wurde; errors wird nur ausgefüllt, wenn die Generierung fehlschlägt.

curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/connect-facebook' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "successUrl": "https://listingsapi.com/docs/api/connected-accounts-trigger-matches", "errorUrl": "https://listingsapi.com/docs/api/connected-accounts-connect-facebook" } }'

Parameter

Body

Beispielanfrage

Antworten