Synup
Schlüssel erstellen
v1Ressourcen/Connections/getFacebook-Verbindungs-URL abrufen

Facebook-Verbindungs-URL abrufen

Gibt eine Facebook-OAuth-Autorisierungs-URL zurück, die in einem Browser geöffnet wird, um die Facebook-Seite dieses Standorts zu verbinden. Dieser Endpunkt kann die Verbindung nicht selbst abschließen — der Facebook-Zustimmungsbildschirm erfordert einen interaktiven Menschen.

get/api/v1/connections/facebook/connect-url
connections:write
Query-Parameter
locationIdstringerforderlich
Der zu verbindende Standort.
clientIdstringoptional
Der Kunde des Standorts. Nur zur Eindeutigkeit nötig, wenn Ihr Schlüssel auf bestimmte Kunden beschränkt ist.
returnUrlstringoptional
App-interner Pfad, auf dem nach Abschluss des Zustimmungsbildschirms gelandet wird. Standard: "/".
successUrlstringoptional
Wohin der Browser des Kunden nach einer erfolgreichen Verbindung gesendet wird. Muss auf dem API-Schlüssel registriert und zusammen mit errorUrl angegeben werden.
errorUrlstringoptional
Wohin der Browser gesendet wird, wenn die Verbindung fehlschlägt oder abgebrochen wird. Gleiche Registrierungsregel, zusammen mit successUrl angegeben.
Antwort
dataobjectoptional
providerstring (google | facebook | apple)optional
Welcher Publisher mit dieser URL verbunden wird: google, facebook oder apple.
locationIdstringoptional
Der Standort, dem diese Verbindung zugeordnet wird, oder null, wenn die Verbindung mit einer clientId gestartet wurde.
clientIdstringoptional
Der Kunde, auf den diese Verbindung beschränkt ist, oder null.
urlstringoptional
Die Autorisierungs-URL — in einem Browser unter Kontrolle des Kontoinhabers öffnen.
successUrlstringoptional
Die für diesen Aufruf verwendete successUrl, oder null im Legacy-Modus.
errorUrlstringoptional
Die für diesen Aufruf verwendete errorUrl, oder null im Legacy-Modus.
notestringoptional
Hinweise zum Öffnen der URL. Erklärt die Partner-Übergabe, wenn successUrl und errorUrl gesetzt sind, andernfalls den Abfrage-Ablauf über GET /api/v1/connections.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/connections/facebook/connect-url
Ihr API-Schlüssel
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."
  }
}

Anleitungen, die diese Ressource verwenden