Conectar una cuenta de Facebook

Parámetros

Cuerpo

Nombre	Tipo	Obligatorio	Descripción
input	object	obligatorio	Wrapper object. The entire request body must be nested under `input`.
input.successUrl	string	obligatorio	URL the user is redirected to after they successfully authorize Facebook. Must be an absolute https URL you control.
input.errorUrl	string	obligatorio	URL the user is redirected to if they cancel or the authorization fails. Must be an absolute https URL you control.

Respuestas

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.

Genera una URL de OAuth de corta duración que un usuario visita para autorizar a Listings API a gestionar sus páginas de Facebook de forma masiva. Redirige al usuario al url devuelto; durante el proceso, revisa y acepta las condiciones de Facebook y concede los permisos de gestión de páginas que Listings API necesita. El enlace es válido durante 24 horas.

Estructura de la solicitud. El cuerpo debe estar envuelto en un objeto input que contenga dos campos obligatorios, successUrl y errorUrl. Estas son las URL https absolutas a las que se redirige al usuario después de que complete (o abandone) el proceso de autorización de Facebook; proporciona endpoints de tu propia aplicación que reanuden la incorporación si la autorización se completa correctamente y ofrezcan volver a intentarlo si se produce un error. No hay ningún campo accountId, el enlace de conexión siempre tiene como ámbito la cuenta a la que pertenece la clave de API y el envío de accountId (o de un cuerpo plano, sin envolver) se rechaza con un HTTP 400.

Este es el equivalente en Facebook del endpoint connect-google y el primer paso del flujo de conexión masiva. Una vez autorizada, la cuenta aparece en GET /connected-accounts con un connectedAccountId que se utiliza para establecer correspondencias y sincronizar.

Caso de uso: incorporación de las páginas de Facebook de un cliente. Después de que un cliente conceda acceso a Facebook, redirígelo al url devuelto. Cuando termine, ejecuta POST /connected-accounts/trigger-matches, revisa los resultados con GET /connected-accounts/{connectedAccountId}/connection-suggestions y confirma las correspondencias mediante POST /connected-accounts/confirm-matches para que los datos de las páginas de Facebook comiencen a sincronizarse con las ubicaciones correspondientes de Listings API.

Caso de uso: volver a autorizar después de rechazar permisos. Si un usuario omite un permiso obligatorio de Facebook, la conexión no puede sincronizarse. Genera de nuevo el enlace y pide al usuario que vuelva a autorizar la conexión concediendo todos los permisos.

Para Google, utiliza el endpoint connect-google. success: true con un url distinto de null significa que se ha generado el enlace; errors solo se rellena cuando falla la generación.

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

Parámetros

Cuerpo

Solicitud de ejemplo

Respuestas