订阅连线

您可以使用图谱 API 的 /app/subscriptions 连线,配置和管理应用的 Webhooks 产品。请参阅我们的 /app/subscriptions 文档,了解使用此连线可以执行的操作及相应的任何必要权限。本文档仅介绍几个常见操作。

创建订阅

如要订阅某个对象及其字段,请发送 POST 请求至 /app/subscriptions 连线,请求中应包含以下参数:

  • object — 要为之设置字段订阅的对象类型(如 user)。
  • callback_url — 您端点的网址。
  • verify_token — 一个 字符串 ,每当我们向您发送验证请求时,都会将此字符串加入其中。
  • fields — 希望订阅的字段(如 photos)。

例如,如果您的应用编号是 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 连线。例如,如果您的应用编号是 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" } ] } ] }