mirror of
https://github.com/luongnv89/claude-howto.git
synced 2026-09-26 13:20:42 +02:00
Luong NGUYEN
b9a973bf32
Internal accuracy pass against v2.1.220 — no missing upstream features, but broken example code, disagreeing counts, and metadata drift.
Functional fixes: pre-commit.sh now exits 2 so it actually blocks; dependency-check.sh reads file_path from stdin JSON instead of $1; database-mcp.json uses ${DATABASE_URL}; broken fences repaired; three command templates had invalid skill names.
Factual corrections: /fork and /subtask unswapped and /subtask added; /fewer-permission-prompts; permissions.defaultMode; dontAsk/auto unreversed; 31 hook events verified name-by-name; subagent depth 3; skill precedence enterprise > project > personal; /output-style removed not deprecated; permissionDecision gained defer.
Follow-up review fixed defects the pass left behind: zh/vi headers claiming 31 events above 25-name lists, a surviving hardcoded DB credential in the MCP README examples, an unbalanced fence swallowing a metadata footer, and non-canonical tool names. All four translated CATALOG summary tables were recounted so their arithmetic holds.
Full detail in CHANGELOG.md under v2.1.220-r2.
71 lines
2.1 KiB
Markdown
71 lines
2.1 KiB
Markdown
<!-- i18n-source: 02-memory/directory-api-CLAUDE.md -->
|
|
<!-- i18n-source-sha: 7f2e773 -->
|
|
<!-- i18n-date: 2026-04-27 -->
|
|
|
|
# API モジュール標準
|
|
|
|
このファイルは /src/api/ 配下のすべてに対し、ルートの CLAUDE.md を補完する。メモリファイルは
|
|
連結されるものであり、上書きされるわけではない。ルートの CLAUDE.md は引き続き適用され、
|
|
Claude Code はこのサブツリー内のファイルを読むときに本ファイルをオンデマンドで読み込む。
|
|
|
|
## API 固有の標準
|
|
|
|
### リクエスト検証
|
|
- スキーマ検証には Zod を使う
|
|
- 入力は必ず検証する
|
|
- 検証エラー時は 400 を返す
|
|
- フィールド単位のエラー詳細を含める
|
|
|
|
### 認証
|
|
- すべてのエンドポイントで JWT トークンを必須とする
|
|
- トークンは Authorization ヘッダに付ける
|
|
- トークンの有効期限は 24 時間
|
|
- リフレッシュトークン機構を実装する
|
|
|
|
### レスポンス形式
|
|
|
|
すべてのレスポンスは次の構造に従う:
|
|
|
|
```json
|
|
{
|
|
"success": true,
|
|
"data": { /* actual data */ },
|
|
"timestamp": "2025-11-06T10:30:00Z",
|
|
"version": "1.0"
|
|
}
|
|
```
|
|
|
|
エラーレスポンス:
|
|
```json
|
|
{
|
|
"success": false,
|
|
"error": {
|
|
"code": "VALIDATION_ERROR",
|
|
"message": "User message",
|
|
"details": { /* field errors */ }
|
|
},
|
|
"timestamp": "2025-11-06T10:30:00Z"
|
|
}
|
|
```
|
|
|
|
### ページネーション
|
|
- カーソルベースページネーションを使う（オフセット方式は使わない）
|
|
- `hasMore` の真偽値を含める
|
|
- 1 ページの最大サイズは 100 まで
|
|
- デフォルトのページサイズ: 20
|
|
|
|
### レート制限
|
|
- 認証済みユーザー: 1 時間あたり 1000 リクエスト
|
|
- 公開エンドポイント: 1 時間あたり 100 リクエスト
|
|
- 上限超過時は 429 を返す
|
|
- retry-after ヘッダを付ける
|
|
|
|
### キャッシュ
|
|
- セッションキャッシュには Redis を使う
|
|
- キャッシュ期間: デフォルト 5 分
|
|
- 書き込み操作時に無効化する
|
|
- キャッシュキーにリソース種別のタグを付ける
|
|
|
|
---
|
|
**Last Updated**: April 9, 2026
|