Skip to content

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

← API-一覧

概要

ブロックエディタ(kishudata 等)用に、ホール別の機種名一覧を返す。管理画面向け。

  • date 指定あり(形式 OK): その日のホール別機種名を返す。該当データなしはホール別の空配列(全機種一覧へはフォールバックしない)。
  • date 欠落・空: 最新日の一覧を返し、それもなければ全機種一覧へフォールバックする。

入力(リクエスト)

param必須型・制約説明
dateいいえ空または YYYY-MM-DD指定かつ形式が正しければその日の一覧(データなしは空配列)。欠落・空の場合は最新日→全機種一覧へフォールバック。空以外で形式不正は args 検証で 400

出力(レスポンス)

成功時 data

field説明
kishuNamesByHallobjectキーは日本語ホール名。値は { 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 + WordPressDailyArticleAdminPermissionCheckerwp_rest nonce + edit_posts)を使用する。AsyncLoadingHandler の IP レート制限は適用しない。