AnyHook ドキュメント

AnyHook には SDK もパッケージも必要ありません。送信元のダッシュボードで Webhook の URL を差し替えるだけで、ハンドラーはこれまでと同じリクエストを受け取り続けます。あらかじめ考えておくことが 1 つあります。リトライと再送には送信元の元のタイムスタンプが付いたままです。そのため、署名に有効期限がある送信元（Stripe、Slack など、/providers に許容範囲の記載があるもの）では、それらを受け入れるために AnyHook-Signature を検証してください。

最速の方法（アカウント不要）：curl -X POST https://anyhook.net/api/v1/quickstart を実行すると、すぐに使える受信 URL と API キーがその場で手に入ります。AI エージェントや手早いテストに向いています。返された claim_url でアカウントに紐付けないと、エンドポイントは 7 日で期限切れになります。返された inbound_url を送信元に設定し、GET /api/v1/events と GET /api/v1/events/{id} でイベントを読み出します。各コマンドはレスポンスの next_steps に載っています。

1. 1
   アカウントを作成する

   anyhook.net/sign-up で無料アカウントを作成します。クレジットカード登録は不要です。
2. 2
   App を作成する

   App は Webhook の送信元ごとに作る受信設定で、送信元 1 つを表します。新しいアカウントでは、最初にこのフォームが開きます。名前（例：「Stripe Production」）と、必要に応じてお使いのサーバーの URL を入力します。AnyHook は受信した各イベントをこの URL に転送します。空欄のままにすると、App は転送せずにすべてを記録します。転送先はいつでも追加でき、Free では App ごとに最大 3 つまでです。
3. 3
   送信元を AnyHook に向ける

   App のページには、受信 URL と、主な送信元でそれを入力する場所（例：Stripe → Developers → Webhooks）が表示されます。そこで、以前の Webhook の URL の代わりに次の受信 URL を貼り付けます。

   https://in.anyhook.net/{user-slug}/{app-slug}

   ページは受信を待ち受けているので、最初のリクエストは数秒以内にページに表示されます。まだ送信できるものがない場合は、同じページで Send a test event（テストイベントを送信）を押します。

App にはそれぞれ、次の形式の一意な受信 URL が割り当てられます。

https://in.anyhook.net/{user-slug}/{app-slug}

• user-slug：アカウントの識別子です。ダッシュボードの設定で確認できます。
• app-slug：App ごとに一意な識別子です。App の名前から自動生成されますが、編集もできます。

受信エンドポイントは、あらゆる POST リクエストを受け付けます。設定時の検証ハンドシェイクにも応答します。hub.mode=subscribe を含む GET（Meta の hub.challenge チェック）には、App の設定前でも自動でそのまま値を返します。それ以外のメソッドには 405 を返します。Web ページや通常の HTML フォームからも送信できます（コードハンドラーを参照）。AnyHook は、イベントを永続キューに入れた時点で、転送先エンドポイントの速度に関係なく約 1 秒で HTTP 200 を返します。送信元が転送先を待つことはありません。

AnyHook は受信したヘッダーから送信元を自動で判別し、ペイロードの署名をエッジで検証します。検証を有効にするには、App の作成時に Webhook のプロバイダーを選び、そのプロバイダーの Webhook 署名シークレット（例：Stripe の whsec_...）を貼り付けます。

検証に失敗したリクエストはエッジで拒否され、エンドポイントには届きません。拒否された件数は App のページに表示されます。毎日最初の 5 件は、ヘッダーとボディを含めて rejected としてイベントログに残るため、拒否の理由を確認できます。

AnyHook は非同期のキューベースのアーキテクチャで、Webhook の送信元とバックエンドを切り離します。

1. エッジで受信：Cloudflare Workers が POST を受け付けて署名を検証し、イベントを永続化した時点で、約 1 秒で 200 を返します。
2. キュー：イベントは永続メッセージキュー（Upstash QStash）に投入されます。この時点で、送信元の HTTP 接続はすでに閉じています。
3. 転送：QStash がイベントを AnyHook の転送処理に届け、転送処理が元のペイロードを転送先エンドポイントに POST します。
4. 記録：受信したヘッダーとボディ、配信ステータス、エンドポイントのレスポンスコードとボディ、レイテンシまで、すべての段階を記録します。

保証の内容をはっきり書いておきます。保証があいまいな中継サービスは、そのあいまいさをコードに押し付けることになるからです。

1. 配信は少なくとも 1 回（at-least-once）で、1 回限り（exactly-once）ではありません。リトライこそがこの製品の中身であり、レスポンスが失われたあとのリトライは新しい配信と区別できません。同じイベントを 2 回受け取ることがときどきあります。そうならないと約束できる中継サービスはなく、約束しているところはうまくいった場合の話をしているだけです。ハンドラーは冪等にする必要があります。重複排除のキーには、AnyHook が X-AnyHook-Delivery で転送するイベント ID を使ってください。
2. 順序は保証しません。リトライと並行配信があるため、あとのイベントが、まだリトライ中の前のイベントより先に届くことがあります。AnyHook より上流でも、ほとんどの送信元は順序を約束していません。順序は到着時刻ではなく、ペイロード内のフィールド（バージョンや updated_at）で判断してください。
3. 署名で重複排除をしないでください。AnyHook-Signature は、リトライが許容範囲から外れないよう、配信試行のたびにあえて新しいタイムスタンプで再署名されます。同じイベントでも、2 回の配信の署名は異なります。変わらないのはイベントの id です。
4. 200 は保存済みを意味します。エッジが 200 を返すのは、イベントを永続化した後だけです。キューが使えなくても予備の保存先が 2 つあり、そのどちらにも保存できないときにだけ 503 を返します。受信 URL が 503 を返したときは何も保存されておらず、送信元自身のリトライが安全網になります。保存したふりをせずに 503 を返すのは、そのためです。

転送先がリトライ対象のエラーを返したりタイムアウトしたりすると、AnyHook は指数バックオフで自動的にリトライします。

リトライされるレスポンスは？

すべてのエラーがリトライの対象になるわけではありません。AnyHook はエンドポイントのレスポンスを分類し、再度試しても直らないエラーで、配信試行もコンピュート枠も消費しないようにしています。

配信試行はそれぞれ、レスポンスボディ全体とステータスコードとともに記録されます。リトライしない 4xx の失敗も、リトライ対象の失敗も、サーキットブレーカーのカウントに含まれます。種類を問わず 20 回連続で失敗すると、サーキットブレーカーが作動します。

失敗の通知

AnyHook はイベントごとではなく、決まったしきい値でメール通知を送ります。そのため、届くメールが増えすぎることはありません。

• 1 回目の失敗：ステータスコードと転送先を記載したアラートをすぐに送ります。
• 5 回連続の失敗：対処の提案を含むエスカレーションのアラートを送ります。
• 20 回連続の失敗：サーキットブレーカーが作動し（後述）、そのアラートを送ります。

メールは、上に挙げたしきい値ごとに 1 通、そのあとはサーキットブレーカーの段階ごと（一時停止のたびと無効化）に 1 通です。イベントごとに 1 通送ることは決してありません。配信が 1 回でも成功すると、カウンターはリセットされます。

同じ転送先への配信が 20 回連続で失敗すると（リトライしない 4xx を含む）、サーキットブレーカーが作動し、段階的に停止時間を延ばしていきます。

仕組み

• 受信は続きます。受信 URL は常に有効で、Stripe や GitHub などからのイベントはそのまま受け付けて保存されます。一時停止するのは、転送先への配信だけです。
• 停止時間が過ぎるたびに、AnyHook はハーフオープンのプローブを送ります。次のイベントで転送先を試し、成功すればサーキットはクローズに戻り、すべてがリセットされます。
• 1 回でも成功すれば、すべてリセットされます：連続失敗回数も作動回数も 0 に戻ります。
• 一時停止中に受信したイベントは、ステータス circuit_open で保存され、転送先が復旧したら再送できます。
• 段階が上がるたびに、転送先 URL、失敗回数、停止時間を記載したメール通知が届きます。
• 転送先が無効化された場合（5 回目の作動）、ダッシュボードから手動で再度有効にする必要があります。

この段階的な方式により、サーバーに復旧の時間を与えつつ、応答しないエンドポイントへのリトライでコンピュート枠が消費されるのを防ぎます。

受信 URL に届いたイベントは、配信の結果にかかわらずすべて記録されます。記録が始まるのは、プロバイダーの向き先を AnyHook にした時点からです。それより前に失敗したイベントは、プロバイダー側にしか残っていません（Stripe の場合は Webhook を再送する方法を参照）。各ログエントリには次の内容が含まれます。

• 受信したヘッダーとボディの全体（送信元から受け取ったまま）
• 配信ステータス：queued → success / retrying / failed / rejected / circuit_open / quota_exceeded。rejected は、AnyHook がイベントを拒否したこと（署名検証の失敗、または転送先 URL のブロック）を意味します。配信は一度も試行されておらず、再送できません。
• 転送先の HTTP レスポンスコードとボディ（配信試行ごと）
• レイテンシ（ミリ秒）
• 配信試行の回数と次のリトライ時刻
• 再送かどうか（is_replay: true）

イベントの保存期間はプランによって異なります。Free：3 日。その間はずっと再送でき、その後は削除されます。Pro：1 年。最初の 30 日間は再送でき、その後は読み取り専用の暗号化アーカイブになります。Scale：7 年。最初の 90 日間は再送でき、その後は読み取り専用の暗号化アーカイブになります。Enterprise：柔軟に対応。

ログにあるイベントは、どれでもダッシュボードからワンクリックで再送できます。再送では、保存したペイロードをバイト単位でそのまま、そのイベントの転送先に送ります。その後で転送先の URL を変更していれば、新しい URL に送ります。

• Dashboard → Events を開く
• イベントを見つけて Replay（再送）をクリックする
• 元のイベントに紐付いた、is_replay: true の新しいイベントが作成される

AnyHook は、特別なモードや CLI なしで、そのままローカル開発に使えます。方法は 2 つあります。

1. トンネル経由のライブ転送

App の転送先を、ローカルマシンを指すトンネルの URL に設定します。トンネルのサービスはどれでも使えます。

# ngrok
ngrok http 3000
# → https://abc123.ngrok.io

# cloudflared
cloudflared tunnel --url http://localhost:3000

# localhost.run
ssh -R 80:localhost:3000 nokey@localhost.run

ダッシュボードで、トンネルの URL を App の転送先にコピーします。AnyHook は、ほかのエンドポイントとまったく同じように Webhook を転送します。リトライ、ログ、署名ヘッダーもすべて同じように動作します。

2. 記録したイベントを localhost に再送

本番環境の実際のイベントを AnyHook にためておき、必要なときにどれでもローカル環境へ再送します。テストイベントを手動で発生させる必要はありません。実際のペイロードで、1 日の再送上限が許す回数までテストできます。

• 転送先をトンネルの URL に切り替える
• Dashboard → Events を開き、任意のイベントで Replay をクリックする
• または API を使う：POST /api/v1/events/{id}/replay
• 元のペイロードがバイト単位でそのまま、現在の転送先に送られる

これは特に、エッジケースのデバッグに役立ちます。本番環境のログで問題のイベントを見つけ、ローカルに再送し、ハンドラーが正しく動くまで繰り返します。

Webhook のペイロードはすべて、データベースに届く前に AES-256-GCM で暗号化して保存されます。対象には、受信したヘッダー、リクエストボディ、転送先ごとの署名シークレットが含まれます。

暗号化には、データベースの認証情報とは別に保管している専用の鍵（AES_SECRET_KEY）を使います。暗号化の鍵なしにデータベースが侵害されても、得られるのは暗号文だけです。平文の Webhook データも、署名シークレットも、顧客情報も得られません。

AnyHook は、イベントがキューに入る前に、Cloudflare のエッジで Webhook の署名を検証します。App に署名シークレットを設定した後は、署名がない、または無効なリクエストは 401 で拒否され、クォータを消費することはありません。署名シークレットがない場合、リクエストは検証されずに転送されます。

署名方式はヘッダーから自動で判別します。App を作成して送信元の種類を選ぶと、AnyHook は署名シークレットを暗号化して保存し、そのプロバイダーに合ったアルゴリズムを使います。

未対応の送信元やカスタムの送信元

Webhook の送信元が対応リストにない場合は、App の作成時に Generic（汎用）を選びます。AnyHook は次のように動作します。

• 受信したすべての POST を受け付けて、キューに入れます。受信時の署名検証はありません。
• ボディをバイト単位でそのまま、プロバイダーの元のヘッダーとともに転送先へ転送します。配信試行のたびに、新しい AnyHook-Signature も付けます。エッジの手前で追加されるインフラのヘッダー（cf-* など）は取り除きます。
• AnyHook-Signature ヘッダーを付けるので、エンドポイントはリクエストが AnyHook を経由したことを検証できます。

Generic の App では、どのシークレットを設定しても、受信時の署名検証は行われません。AnyHook-Signature が証明するのはリクエストが AnyHook を経由したことで、誰が AnyHook に送ったかではありません。送信者の確認が必要なら、送信元の元のヘッダー（そのまま転送されます）の検証を自分で続けてください。送信元が Standard Webhooks（webhook-id、webhook-timestamp、webhook-signature。OpenAI や Replicate が採用）で署名している場合は、代わりにその送信元を選んでください。エッジで検証されます。

転送先ごとに任意の設定が 3 つあり、いずれも Pro 以上で使えます。App → Destinations → Delivery controls で設定するか、PATCH /api/v1/apps/{slug} で転送先オブジェクトに指定します。Free のアカウントでも、有料プランだったときに設定した制御はそのまま残りますが、変更はできません。

{
  "destinations": [{
    "url": "https://api.example.com/hooks/stripe",
    "event_types": ["invoice.*", "checkout.session.completed"],
    "rate_limit": 20,
    "delay_seconds": 5
  }]
}

Pro と Scale では、App が受信するすべてのイベントで、自分のコードをサンドボックス内で実行できます。自前のサーバーは必要ありません。コードを保存すると、そのコードを実行する転送先が App に追加されます。そのため、リトライ、再送、サーキットブレーカー、イベントログはほかの転送先と同じように動作し、各実行のコンソール出力と戻り値がその配信のレスポンスになります。コードは App の Code セクションか、以下のエンドポイントで書きます。よくある処理のテンプレートは /code-templates.md にあり、Pipedream からの移行には専用のガイドがあります。

export default async function (event, { env, store }) {
  // event: { method, headers, body, raw_body, delivery_id, attempt }
  console.log(event.body);
}

• イベント。body は、パース済みの JSON、フォームのフィールド（urlencoded、またはマルチパートフォームのテキストフィールド）、あるいは生のテキストです。raw_body は受信したままのテキストです。method は常に POST で、クエリ文字列、パス、呼び出し元の IP は保持されません。delivery_id はイベントの X-AnyHook-Delivery の ID で、attempt は 1 から数え、テスト実行では 0 です。
• 失敗。例外を投げると配信は失敗になり、プランの配信試行回数の範囲でリトライされます（リトライスケジュール）。実行が成功したイベントのリトライでは、コードは再実行されません。一方、外部への呼び出しが通った後で失敗した実行は再実行されるため、API が対応していれば、そうした呼び出しには delivery_id を冪等キーとして使ってください。
• Pipedream のステップ。export default defineComponent({ async run({ steps, $ }) {} }) もそのまま動きます。steps.trigger.event は上記のイベントで、$.export と $.flow.exit も使えます。data_store の prop はすべて App のストアになります。app prop の $auth.field はシークレット APP_FIELD を、それ以外の prop は同じ名前のシークレットを読み込みます（channelId なら CHANNEL_ID）。引き継げないものは Pipedream のガイドに載っています。
• npm パッケージ。コードが import するパッケージは、保存時にインストールされます。バージョンは Pipedream と同じ書き方で固定でき（import axios from "axios@1.7.9"）、最大 20 個までです。新しいパッケージをインストールする保存には、数分かかることがあります。インストールに失敗した場合は、何も保存されません。
• シークレット。env.NAME または process.env.NAME で読み取ります。最大 20 個まで設定できます。名前には英字、数字、アンダースコアを使い、数字で始めることはできません。PATH, HOME, NODE_OPTIONS, NODE_PATH, PWD と、ANYHOOK_ で始まる名前はランタイムが使用します。値は最大 4,000 文字です。値がサーバーの外に出ることはありません。
• ストア。store.get、set（{ ttl } に秒数を指定）、has、delete、keys、entries、clear で、イベント間で状態を保持できます。ストアは App ごとに 1 つで、キーは最大 1,000 個、各キーは最大 256 文字、各値は JSON で最大 64,000 バイトです。インポートは {"entries": {key: value}} の形式で受け付け、既存のキーを上書きし、TTL なしで設定します。
• スケジュール。schedule は 5 つのフィールドからなる cron 式で、CRON_TZ=Area/City を前に付けない限り UTC です。スケジュールが起動するたびに、anyhook.schedule イベントが App 自身の URL に投稿されます。そのため実行 1 回とイベント 1 件としてカウントされ、起動するのはコードがオンの間だけです。App の送信元は generic か auto で、署名シークレットなしにする必要があります。スケジュールで動かすコードには、専用の App を用意してください。
• メール。どの App も {user-slug}.{app-slug}@anyhook.net でメールを受信でき、email.received イベントになります。ボディには from、to、subject、message_id、date、size と、MIME メッセージ全体の raw が入ります。スケジュールと同じく、送信元が generic か auto で、署名シークレットのない App が必要です。プランのペイロード上限を超えるメールはバウンスされます。
• Web ページとフォーム。ページから受信 URL に fetch() できます。エッジが CORS のプリフライトに応答し、すべての応答に Access-Control-Allow-Origin: * が付きます。通常の HTML フォームには method="post" が必要です。action に ?redirect=https://your-site.com/thanks を付けると、イベントを保存した後、303 で訪問者をそのアドレスに移動させます。ただし、そのアドレスがフォームを送信したサイトと同じサイトにある場合に限ります。そうでない場合、訪問者には「Received」という短いページが表示されます。テキストフィールドは event.body に入りますが、アップロードされたファイルは残りません。
• 上限。コードは最大 64,000 バイトで、実行時間は Pro で 105 秒、Scale で 285 秒までです。各実行では、コンソール出力の末尾 16,000 文字が保持されます。月間の実行回数はプランの表にあり、リトライ、テスト実行、再送、スケジュールの起動を含めて、すべての実行がカウントされます。超過料金はありません。月間の実行回数を超えると、コードへの配信は 429 を返して保留（circuit_open）になり、リトライはされません。翌月になるかプランを上げれば、再送できます。
• テストとオン/オフ。POST .../code/test は、App に保存された最新のイベント、指定した event_id、または渡した body で保存済みのコードを実行し、ログ、戻り値、所要時間を返します。実行 1 回としてカウントされ、何も配信しませんが、コード自身が送信するものは実際に送信されます。イベントがコードを実行するのは、コードがオンの間だけです。ダッシュボードは、新しいコードをオフの状態で保存します。一方、PUT .../code は、"enabled": false を渡さない限り、最初のバージョンをオンの状態で保存します。その後の保存では、現在の状態が維持されます。移行中のように、別の転送先がまだ同じイベントを処理している間は、"enabled": false で保存し、その転送先を削除してからコードをオンにしてください。どちらの変更も、すべてのエッジロケーションに反映されるまで最大 1 分かかります。

API リクエストにはすべて、Authorization ヘッダーに Bearer トークンが必要です。

Authorization: Bearer ahk_live_xxxxxxxxxxxxxxxx

API キーは Dashboard → Settings → API Keys で発行します。キーはアカウント単位で、フルアクセスか読み取り専用かを作成時に選べます。キーはいつでも失効させられます。MCP のログイン（anyhook.net/mcp）で接続したアプリは、承認したアクセス権の範囲内で、OAuth アクセストークンを使って同じエンドポイントを呼び出せます。

AnyHook は https://anyhook.net/mcp で動く MCP サーバーです。エージェントが代わりに App の作成、イベントログの読み取り、失敗した配信の再送を行えます。Pro と Scale では、App のコードのデプロイとテストもできます（anyhook_code_deploy、anyhook_code_test、anyhook_code_get）。Claude Code、claude.ai、Codex、VS Code は URL とブラウザーでのログインだけで接続でき、キーをコピーする必要はありません。クライアントごとの手順を参照してください。

Cursor、Windsurf、Claude Desktop ではキーを使います。Dashboard → Settings → API Keys でキーを作成すると、キーが入った状態で次の設定が表示されます。

{
  "mcpServers": {
    "anyhook": {
      "command": "npx",
      "args": [
        "-y",
        "anyhook-mcp"
      ],
      "env": {
        "ANYHOOK_API_KEY": "ahk_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor：Settings → MCP → Add new MCP server、または ~/.cursor/mcp.json。Windsurf：~/.codeium/windsurf/mcp_config.json。Claude Desktop：Settings → Developer → Edit Config。コードのツールを使うには、anyhook-mcp 0.4.0 以降（npx -y で取得されます）か、https://anyhook.net/mcp のサーバーが必要です。

そのあと、エージェントに「Stripe の Webhook 用に AnyHook の App を作成して、その URL を教えてください。」と頼みます。エージェントは、この内容をすべて /llms.txt で読めます。

料金の詳細を見る →