コード生成中級

REST API エンドポイントの新規作成

CRUD 操作を含む REST API エンドポイントをレイヤード・アーキテクチャで生成するプロンプト。

監修: 平原尚樹

株式会社BlueAI 代表取締役CEO / ソフトウェアエンジニア / プロダクトエンジニア / Google Cloud Architect / 元AIスタートアップ(Doorkel)

監修: 酒井歩乃加

早稲田大学文化構想学部卒業 / フリーランス編集者・ライター / 元マイベスト編集ディレクター / SEO対策記事・取材記事執筆

こんな課題を解決

新しいリソースの API エンドポイントを作るたびに、ルーティング・バリデーション・ビジネスロジック・DB 層を手書きするのが時間がかかる。

プロンプト

Claude Code に入力

以下のリソースの REST API エンドポイントを作成してください。

## リソース
- 名前: Products（商品）
- フィールド:
  - id: UUID（自動生成）
  - name: string（必須、最大100文字）
  - description: string（任意、最大1000文字）
  - price: integer（必須、0以上）
  - category: enum（electronics, clothing, food, other）
  - is_active: boolean（デフォルト true）
  - created_at, updated_at: timestamp

## エンドポイント
- GET /api/v1/products（一覧、ページネーション・フィルタ・ソート対応）
- GET /api/v1/products/:id（詳細）
- POST /api/v1/products（作成）
- PUT /api/v1/products/:id（更新）
- DELETE /api/v1/products/:id（論理削除）

## 技術要件
- 既存のアーキテクチャ（handler → service → repository）に従う
- バリデーション: リクエストボディのバリデーション
- エラーハンドリング: 統一的なエラーレスポンス形式
- テスト: ユニットテスト + 統合テスト

実行結果の例

Claude Code が以下を生成します: - handler 層: ルーティングとリクエスト/レスポンス処理 - service 層: ビジネスロジック - repository 層: DB クエリ - テストファイル: 各層のテスト - OpenAPI スキーマの更新

コツ・ポイント

既存のエンドポイントを参考に、と伝えるとアーキテクチャに合った生成になる
認証・認可の要件も明記するとミドルウェア設定まで生成される
ページネーションの方式（offset/cursor）を指定する