API リファレンス
この章では、公開ドキュメントとして扱うべき API（ブラウザクライアントと第三者検証で利用するエンドポイント）を、現行実装ベースで説明します。
この部に含まれる章
- エンドポイント一覧 — 外部クライアント向け API のリクエスト/レスポンス仕様
- セッションライフサイクル — クライアントとサーバーのセッション管理実装
想定読者と前提
- 想定読者: ブラウザクライアントや第三者検証ツールから API を呼び出す実装者
- 前提: HTTP / セッションヘッダーの基本と、本書 全体像 のフローを把握していること
本章で扱わないもの
- 内部運用/デバッグ向け API（
/api/debug/*、/api/finalize/callback）の詳細 - レート制限・Turnstile・capability TTL などの環境変数チューニング
- Amplify / Hono / Lambda 側の認可・ルーティング実装