Appearance
API-001-14 kishudata 非同期取得
概要
[kishudata] ショートコード(SC-009)の公開画面 HTML を非同期取得する(Issue #2203)。初回 HTML ではプレースホルダのみ返し、daily_article_orchestrator.js または kishudata-lazy.js が DOMContentLoaded 後に fetch する。考察本文は同期のまま。
入力(リクエスト)
| param | 必須 | 型・制約 | 説明 |
|---|---|---|---|
day | はい | 非空文字列 | 対象日付(YYYY-MM-DD / YYYY/MM/DD / YYYYMMDD。SC-009 と同義) |
hall | はい | 非空文字列 | 対象ホール名(日本語。HallEnum 対応) |
kishu | はい | 非空文字列 | 機種名(複数は '_' 区切り。SC-009 と同義) |
出力(レスポンス)
成功時 data
| field | 型 | 説明 |
|---|---|---|
success | boolean | 常に true |
html | string | KishuDataController + kishudata.twig 相当の HTML |
assets | object | 動的読み込み用 CSS/JS(kishudata.css / kishudata-details.js) |
HTTP ステータス: 200
失敗・エラー条件
| 条件 | レスポンス形式 |
|---|---|
| バリデーションエラー | { "success": false, "error": { "message": "..." } }(400) |
| nonce 不正 / レート制限超過 | WordPress REST 標準(403 等) |
| サーバー内部エラー | { "success": false, "error": { "message": "..." } }(500) |
assets.styles(CSS handle 一覧)
| handle | ファイル |
|---|---|
kishudata-css | templates/kishudata/kishudata.css |
assets.scripts(JS handle 一覧)
| handle | ファイル |
|---|---|
kishudata-details-js | templates/kishudata/kishudata-details.js |
権限・nonce
名前空間共通事項は API-一覧 を参照。本エンドポイントは API-001-3 等と同様、AsyncLoadingHandler + WordPressAsyncLoadingPermissionChecker(nonce + IP レート制限)を使用する。差分はなし(共通のみ)。