Граница контекста для подписок

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

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

Чтобы подписаться на объект и его поля, отправьте запрос 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" } ] } ] }