Synup
Crear clave
v1Recursos/Connections/getObtener una URL de conexión de Facebook

Obtener una URL de conexión de Facebook

Devuelve una URL de autorización de OAuth de Facebook para abrir en un navegador y conectar la Página de Facebook de esta ubicación. Este endpoint no puede completar la conexión por sí mismo — la pantalla de consentimiento de Facebook requiere un humano interactivo.

get/api/v1/connections/facebook/connect-url
connections:write
Parámetros de consulta
locationIdstringobligatorio
La ubicación a conectar.
clientIdstringopcional
El cliente de la ubicación. Solo necesario para desambiguar cuando su clave está limitada a clientes específicos.
returnUrlstringopcional
Ruta interna de la app donde aterrizar después de que el humano complete la pantalla de consentimiento. Por defecto, "/".
successUrlstringopcional
A dónde se envía el navegador del cliente tras una conexión exitosa. Debe estar registrada en la clave de API y proporcionarse junto con errorUrl.
errorUrlstringopcional
A dónde se envía el navegador si la conexión falla o se cancela. Misma regla de registro, y se proporciona junto con successUrl.
Respuesta
dataobjectopcional
providerstring (google | facebook | apple)opcional
Qué publisher conecta esta URL: google, facebook o apple.
locationIdstringopcional
La ubicación a la que se empareja esta conexión, o null cuando la conexión se inició con un clientId.
clientIdstringopcional
El cliente al que se limita esta conexión, o null.
urlstringopcional
La URL de autorización — ábrala en un navegador bajo el control del propietario de la cuenta.
successUrlstringopcional
La successUrl usada en esta llamada, o null en modo heredado.
errorUrlstringopcional
La errorUrl usada en esta llamada, o null en modo heredado.
notestringopcional
Indicaciones para abrir la URL. Explica el traspaso de partner cuando successUrl y errorUrl están definidas, o el flujo de sondeo de GET /api/v1/connections en caso contrario.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/connections/facebook/connect-url
Su clave de API
locationId *
clientId
returnUrl
successUrl
errorUrl
{
  "data": {
    "provider": "facebook",
    "locationId": "loc_456",
    "clientId": null,
    "url": "https://www.facebook.com/v19.0/dialog/oauth?client_id=...&redirect_uri=...&scope=...&state=...&response_type=code",
    "successUrl": null,
    "errorUrl": null,
    "note": "Open this URL in a browser under the account owner's control. There is no callback to your integration. Once approved, poll GET /api/v1/connections to see the new connection. Pass successUrl and errorUrl (registered on this key) to have the browser sent back to you with a one-time code instead."
  }
}

Guías que usan este recurso