Appearance
API-001-7 パフォーマンス計測
概要
日別記事テンプレート(DailyArticleTemplateController)実行をプロファイリングし、クエリ数・実行時間・メモリ・出力長などを JSON で返す開発・管理者向けエンドポイント。同機能のショートコードは SC-011。
入力(リクエスト)
register_route に args は定義しない。コールバック内でソフト読取する。
| param | 必須 | 型・制約 | 説明 |
|---|---|---|---|
date | いいえ | 指定時は YYYY-MM-DD。省略時は最新日付 | 計測対象日(LinkDayRepository::get_latest_date() フォールバック) |
halls | いいえ | カンマ区切り文字列。省略時は下記デフォルト | 計測対象ホール。既定: アイランド秋葉原,エスパス秋葉原 |
出力(レスポンス)
成功時 data
| field | 型 | 説明 |
|---|---|---|
success | boolean | 常に true |
parameters | object | { date: string, halls: string }(適用された計測条件) |
performance | object | query_count / execution_time / memory_usage / memory_usage_mb |
output_length | int | テンプレート出力(ショートコード展開後)のバイト長 |
performance.top_5_queries はローカル環境、または manage_options のときのみ付与。
HTTP ステータス: 200
失敗・エラー条件
| 条件 | レスポンス形式 |
|---|---|
date 形式不正 | { "success": false, "error": { "message": "..." } }(400) |
| 権限不足 | WordPress REST 標準(403 等) |
| サーバー内部エラー | { "success": false, "error": { "message": "..." } }(500) |
権限・nonce
名前空間共通事項は API-一覧 を参照。本エンドポイントは PerformanceMeasurementHandler + WordPressPermissionChecker(ローカルは capability 省略、それ以外は manage_options)を使用する。PermissionChecker 内での wp_rest nonce 検証は行わない(API-一覧の「nonce を検証しない」行に該当)。IP レート制限も適用しない。