Connecter un compte Facebook

Paramètres

Corps

Nom	Type	Obligatoire	Description
input	object	obligatoire	Wrapper object. The entire request body must be nested under `input`.
input.successUrl	string	obligatoire	URL the user is redirected to after they successfully authorize Facebook. Must be an absolute https URL you control.
input.errorUrl	string	obligatoire	URL the user is redirected to if they cancel or the authorization fails. Must be an absolute https URL you control.

Réponses

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.

Génère une URL OAuth à durée de validité limitée que l'utilisateur ouvre pour autoriser Listings API à gérer ses pages Facebook en masse. Redirigez l'utilisateur vers url renvoyé ; au cours du processus, il consulte et accepte les conditions de Facebook et accorde les autorisations de gestion des pages dont Listings API a besoin. Le lien est valable pendant 24 heures.

Structure de la requête. Le corps doit être enveloppé dans un objet input contenant deux champs obligatoires, successUrl et errorUrl. Il s'agit des URL https absolues vers lesquelles l'utilisateur est redirigé après avoir terminé (ou abandonné) le processus d'autorisation Facebook ; fournissez des points de terminaison de votre propre application qui reprennent l'intégration en cas de succès et proposent une nouvelle tentative en cas d'erreur. Il n'existe aucun champ accountId, le lien de connexion est toujours limité au compte auquel appartient la clé API, et l'envoi de accountId (ou d'un corps à plat, sans objet englobant) est rejeté avec un statut HTTP 400.

Il s'agit de l'équivalent Facebook du point de terminaison connect-google et de la première étape du processus de connexion en masse. Une fois l'autorisation accordée, le compte apparaît dans GET /connected-accounts avec un connectedAccountId utilisé pour la mise en correspondance et la synchronisation.

Cas d'utilisation : intégration des pages Facebook d'un client. Une fois qu'un client a accordé l'accès à Facebook, redirigez-le vers url renvoyé. Lorsqu'il a terminé, exécutez POST /connected-accounts/trigger-matches, examinez les résultats avec GET /connected-accounts/{connectedAccountId}/connection-suggestions et confirmez les associations via POST /connected-accounts/confirm-matches pour que les données des pages Facebook commencent à se synchroniser avec les établissements Listings API correspondants.

Cas d'utilisation : renouvellement de l'autorisation après un refus de permissions. Si un utilisateur n'accorde pas une permission Facebook obligatoire, la connexion ne permet pas la synchronisation. Générez à nouveau le lien et demandez-lui de renouveler l'autorisation en accordant toutes les permissions.

Pour Google, utilisez le point de terminaison connect-google. success: true avec une valeur non nulle pour url signifie que le lien a été généré ; errors n'est renseigné que si la génération échoue.

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

Paramètres

Corps

Exemple de requête

Réponses