Webhooks Meta

Граница контекста subscriptions

С помощью границы контекста /app/subscriptions в API Graph можно настраивать продукт Webhooks в приложении и управлять им. Ознакомиться со всеми ее операциями и необходимыми разрешениями можно в этой статье. В этом документе рассматривается лишь несколько распространенных операций.

Создание подписок

Чтобы подписаться на объект и его поля, отправьте запрос POST к границе контекста /app/subscriptions, указав следующие параметры:

  • object — тип объекта, на поля которого нужно подписаться (например, user);
  • callback_url — URL конечной точки;
  • verify_token — строка (string), которую мы включим в отправляемый вам запрос подтверждения;
  • fields — поля, на которые нужно подписаться (например, photos).

Например, чтобы получать уведомления о публикации новых фото пользователем приложения с ID 188559381496048, можно сделать следующее:

Пример запроса

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"

Пример ответа

В случае успеха:

{
  "success": "true"
}

Получение информации о подписках

Чтобы проверить настроенные для приложения подписки на объекты и поля, отправьте запрос GET к границе контекста /app/subscriptions. Пример для приложения с ID 188559381496048:

Пример запроса

GET graph.facebook.com/188559381496048/subscriptions

Пример ответа

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