API-001-8 日付ホール別機種名

← API-一覧

概要

ブロックエディタ（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 不正 / 権限不足	401 / 403

日付未指定・空の場合はエラーにせず最新日（なければ全機種一覧）へフォールバックする。date 指定で該当データがない場合は空配列（200）であり、全機種フォールバックはしない。

権限・nonce

名前空間共通事項は API-一覧 を参照。本エンドポイントは KishuNamesHandler + WordPressDailyArticleBotPermissionChecker（edit_daily_articles。nonce は検証しない）を使用する。管理画面のブロックエディタ（Cookie + wp_rest nonce）と日別記事編集bot（アプリケーションパスワード）の両方から呼ぶ。Cookie 認証で nonce が無いリクエストは WordPress コアが未ログイン扱いにするため 401 になる。AsyncLoadingHandler の IP レート制限は適用しない。

旧 WordPressDailyArticleAdminPermissionChecker からの挙動の違い（#3872 で切り替え）:

項目	旧（Admin Checker）	現在（Bot Checker）
nonce が無い Cookie リクエスト	403（AUTH_FAILED）	401（LOGIN_REQUIRED。WordPress コアが未ログイン扱いにする）
nonce が不正な Cookie リクエスト	403	403（WordPress コアの rest_cookie_invalid_nonce）
Local バイパス（LocalRestBypassGuard）	効かない	効く（ローカルで SLOT_KOURYAKU_ALLOW_LOCAL_REST_BYPASS をオプトインしたときだけ）

編集画面の JS はステータスコードで分岐していないため、401 / 403 の違いは画面に影響しない。