Synup
Créer une clé
v1Ressources/Connexions/getObtenir une URL de connexion Facebook

Obtenir une URL de connexion Facebook

Renvoie une URL d'autorisation OAuth Facebook à ouvrir dans un navigateur pour connecter la Page Facebook de cet emplacement. Cet endpoint ne peut pas terminer la connexion lui-même — l'écran de consentement Facebook nécessite un humain interactif.

get/api/v1/connections/facebook/connect-url
connections:write
Paramètres de requête
locationIdstringobligatoire
L'emplacement à connecter.
clientIdstringfacultatif
Le client de l'emplacement. Nécessaire uniquement pour lever une ambiguïté lorsque votre clé est limitée à des clients spécifiques.
returnUrlstringfacultatif
Chemin interne de l'application où atterrir après que l'humain a terminé l'écran de consentement. Par défaut, "/".
successUrlstringfacultatif
Où le navigateur du client est envoyé après une connexion réussie. Doit être enregistrée sur la clé d'API et fournie avec errorUrl.
errorUrlstringfacultatif
Où le navigateur est envoyé si la connexion échoue ou est annulée. Même règle d'enregistrement, et fournie avec successUrl.
Réponse
dataobjectfacultatif
providerstring (google | facebook | apple)facultatif
Quel publisher cette URL connecte : google, facebook ou apple.
locationIdstringfacultatif
L'emplacement auquel cette connexion est associée, ou null lorsque la connexion a été démarrée avec un clientId.
clientIdstringfacultatif
Le client auquel cette connexion est limitée, ou null.
urlstringfacultatif
L'URL d'autorisation — à ouvrir dans un navigateur sous le contrôle du titulaire du compte.
successUrlstringfacultatif
La successUrl utilisée pour cet appel, ou null en mode hérité.
errorUrlstringfacultatif
L'errorUrl utilisée pour cet appel, ou null en mode hérité.
notestringfacultatif
Indications pour ouvrir l'URL. Explique le relais partenaire lorsque successUrl et errorUrl sont définies, ou le flux d'interrogation de GET /api/v1/connections sinon.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/connections/facebook/connect-url
Votre clé 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."
  }
}

Guides qui utilisent cette ressource