Skip to content

API-001-3 末尾データ非同期取得

← API-一覧

概要

日別記事結果の末尾データ(台番号末尾別集計)HTML を非同期で取得する。初期 HTML ではプレースホルダーのみ出力し、本エンドポイントで末尾データ断片を返す。

入力(リクエスト)

param必須型・制約説明
hallはい非空 string(英字 value)ホール識別子(例: island)。日別記事で利用可能なホールのみ
dateいいえ空または YYYY-MM-DD対象日
hallsいいえ英字スラッグの配列、またはカンマ区切り CSVargs 未登録。クエリに含まれる場合のみ Converter が template_halls とし L2 warm に使用。不正値は Converter で 400

出力(レスポンス)

成功時 data

field説明
successboolean常に true
htmlstring末尾データセクション HTML 断片
assetsobject動的読み込み用 CSS/JS(他 async と同型)

HTTP ステータス: 200

失敗・エラー条件

条件レスポンス形式
バリデーションエラー{ "success": false, "error": { "message": "..." } }(400)
nonce 不正 / レート制限超過WordPress REST 標準(403 等)
サーバー内部エラー{ "success": false, "error": { "message": "..." } }(500)

assets.styles(CSS handle 一覧)

assets は動的注入用メタデータ(クライアントが loadStylesFromAssets / loadAssetsDynamically で読む)。API が CSS 本体を配信するわけではない。

下表は Controller が候補にする handle(意図マップ)。end-number-data-cssAssetUtil::PUBLIC_CSS_BUNDLE_SUPPRESSED_HANDLES の対象外のため、公開 CSS バンドルがあっても 現状は REST assets.styles に含まれる

handleファイル
end-number-data-csstemplates/end_number_data/end_number_data.css

assets.scripts(JS handle 一覧)

assets.scripts は公開 CSS バンドル抑止の対象外。

handleファイル
end-number-details-jstemplates/end_number_data/end-number-details.js

権限・nonce

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