Skip to main content
Webhooks

Webhook テストイベントを送信する

Endpoint にテストイベントを送信し、受信 URL と署名処理を確認します。

Webhook は現在 Beta 機能です。API、フィールド、および動作は今後のバージョンで変更される可能性があります。
POST /api/v1/forward/webhook/endpoints/{endpoint_id}/test テストイベントのタイプは webhook.test で、Endpoint の購読一覧に追加する必要はありません。配信は非同期です。API の成功レスポンスはテストイベントが受理されたことを示し、受信側の処理完了を示すものではありません。 呼び出す前に Endpoint が有効であることを確認してください。無効な場合でも API が 202 を返すことがありますが、delivery_rows は 0 となりコールバックは送信されません。

リクエストヘッダー

Header必須説明
AuthorizationはいBearer <PAT または管理者 SAT>

パスパラメーター

パラメーター型必須説明
endpoint_idstringはいWebhook Endpoint ID。

リクエスト例

curl -s -X POST 'https://api.qoder.com/api/v1/forward/webhook/endpoints/e149c233-1234-4abc-8def-1234567890ab/test' \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 202 Accepted 
{
  "event_id": 433,
  "delivery_rows": 1
}

レスポンスフィールド

フィールド型説明
event_idintegerこのテストリクエストの識別子。
delivery_rowsintegerこのテストで受理された配信タスク数。
Endpoint が受信するテストイベントの例： 
{
  "type": "event",
  "id": "whe_01k1jbxexample",
  "endpoint_id": "e149c233-1234-4abc-8def-1234567890ab",
  "emitted_at": "2026-09-01T09:01:22Z",
  "note": "This is a synthetic test event."
}

エラー

HTTPType発生条件
401authentication_error認証情報がない、無効、または期限切れです。
403permission_error現在のトークンでは Webhook を管理できません。
404not_found_errorEndpoint が存在しないか、現在のアカウントから参照できません。
500/502/503api_errorテストイベントを一時的に送信できません。

関連

Webhook イベントを受信する

Webhook Endpoint を取得する

はじめに
Agent の定義
Agent 環境の設定
Agent にタスクを委任する
Agent 連携
Agent コンテキストの管理
アカウント
ベストプラクティス
お知らせ
API リファレンス
Webhook テストイベントを送信する - Qoder