Meta-Webhooks

Subscriptions-Edge

Mit der /app/subscriptions-Edge der Graph API kannst du das Webhook-Produkt deiner App konfigurieren und verwalten. In unserer /app/subscriptions-Dokumentation erfährst du, welche Vorgänge mit dieser Edge möglich sind und welche Berechtigungen du dafür benötigst. In diesem Dokument werden nur einige allgemeine Vorgänge beschrieben.

Erstellen von Abonnements

Um ein Objekt und dessen Felder zu abonnieren, sende eine POST-Anfrage mit den folgenden Parametern an die /app/subscriptions-Edge:

  • object: Typ des Objekts, für das du Feldabonnements einrichten möchtest (beispielsweise user).
  • callback_url: URL deines Endpunkts.
  • verify_token: Ein string, den wir in jede Verifizierungsanfrage an dich aufnehmen.
  • fields: Die Felder, die du abonnieren möchtest (beispielsweise photos).

Beispielanfrage, wenn die ID deiner App 188559381496048 lautet und du benachrichtigt werden möchtest, wenn App-Nutzer ein neues Foto veröffentlichen:

Beispielanfrage

curl -F "object=user" \ -F "callback_url=https://your-clever-domain-name.com/webhooks" \ -F "fields=photos" \ -F "verify_token=your-verify-token" \ -F "access_token=your-app-access-token" \ "https://graph.facebook.com/188559381496048/subscriptions"

Beispielantwort

Bei Erfolg:

{
  "success": "true"
}

Abrufen von Abonnementinformationen

Um die für deine App eingerichteten Objekt- und Feldabonnements anzuzeigen, sende eine GET-Anfrage an die /app/subscriptions-Edge. Beispielanfrage, wenn die ID deiner App 188559381496048 lautet:

Beispielanfrage

GET graph.facebook.com/188559381496048/subscriptions

Beispielantwort

{ "data": [ { "object": "user", "callback_url": "https://your-clever-domain-name.com/webhooks", "active": true, "fields": [ { "name": "photos", "version": "v2.10" }, { "name": "feed", "version": "v2.10" } ] } ] }