Webhook イベントの取得 | ToAPIs Documentation

GET

/api/v1/webhook/events/{event_id}

中国本土のユーザー向け: 中国本土のユーザーは https://api.toapis.cn を API エンドポイント (Base URL)としてご利用ください. 本ドキュメント内の例では https://api.toapis.com を https://api.toapis.cn に置き換えてください.

動作

単一の配送イベントの最新状態とリトライ状況を返します: イベント状態, 試行回数, 最終 HTTP ステータス, マスク済み reason, RFC 3339 タイムスタンプ. イベント payload, コールバック URL, 受信側の生レスポンス, 配信を実行した worker の情報, 各リトライの全明細は返しません.

他アカウントまたは存在しないイベントは 404 です.

認証

Authorizationstringヘッダー必須

システムアクセストークン Bearer YOUR_SYSTEM_ACCESS_TOKEN を使用します. 自分のアカウントのみ対象です. モデル Key は利用できません. X-User-Id は不要で, 管理者やチームの権限による例外もありません.

リクエストパラメータ

event_idstringパス必須

イベント ID.

event_id が存在しないか他アカウントのものは 404, レート制限時は 429 を返します.

リクエスト例

curl --request GET \
  --url 'https://api.toapis.com/api/v1/webhook/events/evt_example' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'

レスポンス例

{
  "code": 0,
  "message": "",
  "data": {
    "event_id": "evt_example",
    "api_key_id": 123,
    "task_id": "example-task",
    "type": "generation.completed",
    "status": "delivered",
    "attempts": 1,
    "reason": "delivered",
    "last_http_status": 200,
    "created_at": "2026-11-13T00:00:00Z",
    "next_attempt_at": null,
    "delivered_at": "2026-11-13T00:00:01Z",
    "expires_at": "2026-11-14T12:00:00Z"
  }
}

初期設定の手順と署名検証はWebhook 設定の取得を参照してください.