Synupv1
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: "/".
Antwort
dataobjectoptional
providerstring (google | facebook)optional
Welcher Publisher mit dieser URL verbunden wird.
locationIdstringoptional
Der Standort, dem diese Verbindung nach Genehmigung zugeordnet wird.
urlstringoptional
Die Autorisierungs-URL — in einem Browser unter Kontrolle des Kontoinhabers öffnen.
notestringoptional
Erklärt, dass es keinen Rückruf an Ihre Integration gibt; danach GET /api/v1/connections abfragen.
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
{
  "data": {
    "provider": "facebook",
    "locationId": "loc_456",
    "url": "https://www.facebook.com/v19.0/dialog/oauth?client_id=...&redirect_uri=...&scope=...&state=...&response_type=code",
    "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."
  }
}