Skip to content

API-001-14 kishudata 非同期取得 ​

← API-一覧

概要 ​

[kishudata] ショートコード(SC-009)の公開画面 HTML を非同期取得する。初回 HTML ではプレースホルダのみ返し、daily_article_orchestrator.js または kishudata-lazy.js が DOMContentLoaded 後に fetch する。考察本文は同期のまま。

入力(リクエスト) ​

param必須型・制約説明
dayはい非空文字列対象日付(YYYY-MM-DD / YYYY/MM/DD / YYYYMMDD。SC-009 と同義)
hallはい非空文字列対象ホール名(日本語。HallEnum 対応)
kishu_idいいえ※非空文字列機種名(複数は '_' 区切り。SC-009 と同義)
kishuいいえ※非空文字列旧属性名(読取フォールバック。kishu_id 未指定時のみ)

※ kishu_id または kishu のいずれか一方が非空であること。

出力(レスポンス) ​

成功時 data ​

field型説明
successboolean常に true
htmlstringKishuDataController + kishudata.twig 相当の HTML
assetsobject動的読み込み用 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-csstemplates/kishudata/kishudata.css

assets.scripts(JS handle 一覧) ​

handleファイル
kishudata-details-jstemplates/kishudata/kishudata-details.js

権限・nonce ​

名前空間共通事項は API-一覧 を参照。本エンドポイントは API-001-3 等と同様、AsyncLoadingHandler + WordPressAsyncLoadingPermissionChecker(nonce + IP レート制限)を使用する。差分はなし(共通のみ)。