API

概要

API は api/template.yaml と api/lambda/ で管理されています。AWS SAM テンプレートが HTTP API Gateway / Cognito JWT Authorizer / Rust Lambda / Lambda 実行ロール を定義し、Rust 側は main.rs から handlers.rs と db.rs を呼び出して /inquiries を処理します。

• SAM テンプレート: ../api/template.yaml
• Lambda エントリーポイント: ../api/lambda/src/main.rs
• ハンドラー: ../api/lambda/src/handlers.rs
• DB 接続: ../api/lambda/src/db.rs
• リクエスト / レスポンス型: ../api/lambda/src/models.rs
• OpenAPI 生成: ../api/lambda/src/bin/generate-openapi.rs
• 関連デプロイ: CI/CD

インフラ構成

Lambda の IAM ロールには dsql:DbConnect 権限があり、実行時は create_db("crudrole", endpoint, region) で Aurora DSQL に接続します。DB ロールと IAM Grant の詳細は データベース を参照してください。

公開エンドポイント

現在の HTTP API は /inquiries のみを公開しています。

テンプレートの CORS 設定には PUT / DELETE / OPTIONS も含まれますが、Lambda にイベントが定義されているのは GET と POST だけです。Lambda 側も未対応メソッドに 405 Method Not Allowed を返します。

認証と CORS

API Gateway は Cognito JWT Authorizer を既定の認可方式にし、次の値を 認証 の CloudFormation Export から読み込みます。

• Issuer: ${StackNamePrefix}-auth-${Stage}-CognitoIssuer
• Audience: ${StackNamePrefix}-auth-${Stage}-CognitoUserPoolClientId

Lambda 側でも JWT クレームを追加検査し、次の条件を満たさない場合は 401 Unauthorized を返します。

• email が存在し、空文字でないこと
• sub が存在し、UUID として解釈できること

CORS は SAM テンプレートの StageCorsMap で切り替えています。

Lambda のレスポンスでも Access-Control-Allow-Origin と Content-Type: application/json を明示的に返します。

リクエスト / レスポンス

GET /inquiries

成功時は 200 OK で次の JSON を返します。

検索条件は email と cognito_sub の両方です。DB には get_inquiries_by_email 関数もありますが、現在の Rust 実装は SeaORM で inquiries テーブルを直接参照しています。

POST /inquiries

リクエスト本文は次の JSON です。

{
  "subject": "件名",
  "body": "本文"
}

成功時は 201 Created を返し、保存した 1 件を inquiry フィールドに包みます。id は UUID v7、created_at は Lambda 実行時刻です。DB には reply / respondent / reply_at カラムもありますが、現行の API レスポンスには含めていません。

実行時設定

Rust 側は create_db("crudrole", endpoint, region) で接続文字列を組み立て、Aurora DSQL SQLx connector 経由で SeaORM 接続を作成します。

エラー動作

OpenAPI の扱い

このリポジトリでは、OpenAPI を API Gateway から逆エクスポートするのではなく、Rust コードから生成しています。api/lambda/src/bin/generate-openapi.rs が utoipa で GET /inquiries と POST /inquiries の契約を組み立て、環境変数から次の値を受け取って YAML を出力します。

api_cicd.yaml の validate と export_openapi、document_cicd.yaml の validate と generate-api-docs がこの生成処理を実行します。export_openapi ジョブは api/openapi-${branch}.yaml を生成して GitHub Release に添付し、document_cicd.yaml は同じ生成物を RapiDoc / Swagger UI / Redoc などの公開ドキュメントに流用します。

api/template.yaml の DefinitionBody には最小限の OpenAPI 断片もありますが、Wiki では Rust 実装から生成される OpenAPI を現在の契約として扱います。

出力値と依存関係

SAM テンプレートは次の Outputs を公開します。

主な依存関係は次の通りです。

関連ページ

• README
• FAQ
• 認証
• データベース
• CI/CD