Appearance
API-001-8 日付ホール別機種名
概要
ブロックエディタ(kishudata 等)用に、ホール別の機種名一覧を返す。管理画面向け。
date指定あり(形式 OK): その日のホール別機種名を返す。該当データなしはホール別の空配列(全機種一覧へはフォールバックしない)。date欠落・空: 最新日の一覧を返し、それもなければ全機種一覧へフォールバックする。
入力(リクエスト)
| param | 必須 | 型・制約 | 説明 |
|---|---|---|---|
date | いいえ | 空または YYYY-MM-DD | 指定かつ形式が正しければその日の一覧(データなしは空配列)。欠落・空の場合は最新日→全機種一覧へフォールバック。空以外で形式不正は args 検証で 400 |
出力(レスポンス)
成功時 data
| field | 型 | 説明 |
|---|---|---|
kishuNamesByHall | object | キーは日本語ホール名。値は { kishu_id: int, name: string, count: int }[]。success フラグはなし |
HTTP ステータス: 200
失敗・エラー条件
| 条件 | レスポンス形式 |
|---|---|
date 形式不正(空以外で YYYY-MM-DD 以外) | WordPress REST の args 検証失敗(400 等) |
| nonce 不正 / 権限不足 | WordPress REST 標準(403 等) |
日付未指定・空の場合はエラーにせず最新日(なければ全機種一覧)へフォールバックする。date 指定で該当データがない場合は空配列(200)であり、全機種フォールバックはしない。
権限・nonce
名前空間共通事項は API-一覧 を参照。本エンドポイントは KishuNamesHandler + WordPressDailyArticleAdminPermissionChecker(wp_rest nonce + edit_posts)を使用する。AsyncLoadingHandler の IP レート制限は適用しない。