omni-webhooks について
omni-webhooksは、APIを通じてWebhookエンドポイント、イベント購読、配信リトライを管理する操作をまとめたものです。OmniRoute APIで通知を管理するユーザー向けです。
主な機能
- 01エンドポイントの登録・一覧・更新・削除
- 02イベント購読の設定
- 03Webhook配信履歴の確認
- 04エンドポイントのテストとURL検証
- 05配信リトライの管理
活用シーン
- 01リクエスト完了や失敗の通知設定
- 02クォータ超過イベントの追跡
- 03利用前のWebhookテスト
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cheaper-inference/ omniroute --skill omni-webhooksインストール後、Claude Code で/omni-webhooksを入力して読み込まれたか確認します。
詳細
概要
Webhook エンドポイントを登録、一覧表示、テスト、削除します。イベントサブスクリプション(request.completed、request.failed、quota.exceeded など)を設定し、配信の再試行を管理します。
認証
すべてのリクエストに、有効な Bearer トークンまたはセッションクッキーが必要です。POST /api/auth/login でトークンを取得するか、ローカル開発用に REQUIRE_API_KEY=false を設定してください。
エンドポイント
GET /api/webhooks
Webhook を取得
curl http://localhost:20128/api/webhooks \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/webhooks
Webhook を作成
curl -X POST http://localhost:20128/api/webhooks \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
GET /api/webhooks/{id}
Webhook › を取得
curl http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
PUT /api/webhooks/{id}
Webhook › を更新
curl -X PUT http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
DELETE /api/webhooks/{id}
Webhook › を削除
curl -X DELETE http://localhost:20128/api/webhooks/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/webhooks/{id}/deliveries
Webhook › › 配信を取得
curl http://localhost:20128/api/webhooks/{id}/deliveries \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/webhooks/{id}/test
Webhook › › テストを実行
curl -X POST http://localhost:20128/api/webhooks/{id}/test \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
POST /api/webhooks/validate-url
Webhook › URL を検証
curl -X POST http://localhost:20128/api/webhooks/validate-url \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
ペイロード
詳細なリクエスト/レスポンススキーマについては、GET /api/openapi/spec または docs/openapi.yaml の OpenAPI 仕様全体を参照してください。
コメント
Markdown 対応