Arête des abonnements

Vous pouvez utiliser l’arête /app/subscriptions de l’API Graph pour configurer et gérer le produit Webhooks de votre application. Consultez notre documentation /app/subscriptions pour connaître les opérations possibles avec cette arête, ainsi que les autorisations requises. Ce document n’aborde que quelques opérations courantes.

Créer des abonnements

Pour vous abonner à un objet et ses champs, envoyez une demande POST à l’arête /app/subscriptions et incluez les paramètres suivants :

• object : type d’objet pour lequel vous souhaitez configurer les abonnements aux champs (par exemple, user).
• callback_url : URL de votre point de terminaison.
• verify_token : string que nous inclurons chaque fois que vous envoyez une demande de vérification.
• fields : champs auxquels vous voulez vous abonner (par exemple, photos).

Par exemple, si votre ID d’app est 188559381496048 et que vous souhaitiez être informé dès qu’un utilisateur de votre application publie une nouvelle photo, vous pouvez procéder comme suit :

Exemple de demande

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" 

Exemple de réponse

En cas de réussite :

{
  "success": "true"
}

Obtenir des informations sur les abonnements

Pour voir les abonnements aux objets et aux champs que vous avez configurés pour votre application, envoyez une demande GET à l’arête /app/subscriptions. Par exemple, si l’ID d’app est 188559381496048, vous pouvez procéder comme suit :

Exemple de demande

GET graph.facebook.com/188559381496048/subscriptions 

Exemple de réponse

{ "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" } ] } ] }