Subscriptions 關係連線

您可以使用圖形 API 的 /app/subscriptions 關係連線設定及管理應用程式的 Webhook 產品。請參閱我們的 /app/subscriptions 說明文件,瞭解可以使用這個關係連線執行的操作,以及執行這些操作必須要有的任何權限。本文件只說明幾項常見操作。

建立訂閱

要訂閱物件及其欄位,請發送一項 POST 要求到 /app/subscriptions 關係連線,同時註明以下參數:

  • object — 您要設定哪一個物件類型的欄位訂閱(例如 user)。
  • callback_url — 您的端點的網址。
  • verify_token — 一個 string,只要我們發送一項 驗證要求給您,一定會附上這個字串。
  • 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" } ] } ] }