Arête des abonnements

Vous pouvez utiliser l’arête /app/subscriptions de l’API Graph pour configurer et gérer le produit des Webhooks de votre application. Consultez notre documentation /app/subscriptions pour voir quelles opérations effectuer avec cette arête et connaître les autorisations requises. Ce document couvre uniquement quelques opérations courantes.

Créer des abonnements

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

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

Par exemple, si votre ID d’application était 188559381496048 et que vous voulez recevoir une notification à chaque fois qu’un utilisateur ou une utilisatrice de votre application publie une nouvelle photo, envisagez de procéder ainsi :

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 l’abonnement

Pour voir les abonnements aux objets et aux champs que vous avez configurés pour votre application, envoyez une requête GET et demandez l’arête /app/subscriptions. Par exemple, si votre ID d’application était 188559381496048, vous pourriez procéder ainsi :

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