MetaのWebhooks

サブスクリプションエッジ

グラフAPIの/app/subscriptionsエッジを使うと、自分のアプリのWebhooks製品の設定や管理をすることができます。このエッジで実行できる操作やそのために必要なアクセス許可について詳しくは、/app/subscriptionsのドキュメントをご覧ください。このドキュメントで説明されているのは、いくつかの一般的な操作だけです。

サブスクリプションの作成

オブジェクトとそのフィールドをサブスクリプション登録するには、/app/subscriptionsエッジにPOSTリクエストを送信し、その際に以下のパラメーターを含めます。

  • object — フィールドサブスクリプション設定の対象となるオブジェクトの種類(userなど)。
  • callback_url — エンドポイントのURL。
  • verify_token — Metaから受け取った認証リクエストに含まれる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"
}

サブスクリプション情報の取得

アプリ用に設定したオブジェクトとフィールドのサブスクリプションを確認するには、/app/subscriptionsエッジにGETリクエストを送信します。例えば、アプリの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" } ] } ] }