Webhooks
Webhook deliveryを一覧表示
GET
/api/v1alpha1/webhooks/{webhook_id}/deliveries1つのendpointに対する配信の試行を、新しい順に返します。endpointがeventを受け取れなくなったときは、ここを確認します。
- アクセス: alphaを有効にしたAPI keyと
MANAGE_WEBHOOKS権限。 - ページング:
limitの既定値は25、最大は100。next_cursorをそのままcursorとして渡します。 - 各recordの内容:
event_id、event_type、status、attempts、next_attempt_at、および応答があった場合は直近のstatus code。payloadとsigning secretは含まれません。
試行が打ち切られた配信は、POST /api/v1alpha1/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliverで改めて実行できます。
認証
apiKey 認証Bearer <token>
場所: header
パスパラメーター
webhook_id*string
登録済みWebhook endpointの識別子です。
クエリパラメーター
cursor?string
前の応答のnext_cursorとして返されたopaqueなcursorです。decode、編集、組み立てをせず、そのままcursorとして渡してください。
limit?number
1ページで返すresource数です。既定値は25で、1から100まで指定できます。
形式
int32範囲
1 <= value <= 100デフォルト
25レスポンスボディ
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1alpha1/webhooks/wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab/deliveries" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "data": [ { "attempts": 1, "created_at": "2026-08-08T10:00:01.000Z", "endpoint_id": "wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "event_id": "evt_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "event_type": "video.indexed", "id": "delivery_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "next_attempt_at": "2026-08-08T10:05:00.000Z", "response_status": 200, "status": "delivered" } ], "has_more": false, "next_cursor": "MDEyMzQ1Njc4OWFitSLKnTQIcJAwDPi07V5EGs76Im3F8rCuUshrBnHuUJY7_8Ie8Stea_TKuhKhDw5XkRdkBI3IKkvsKT9Kp60Wpx7CoTCGQW8FnalDILVbuy8wxvWWf_B8SA"}