Appearance
API-001-4 機種指定データ検索
概要
日別記事結果のデータ検索(指定機種の機種全体・台別情報)HTML を非同期で取得する。検索ボタン押下時などに呼び出し、機種名に一致する結果断片を返す。
入力(リクエスト)
| param | 必須 | 型・制約 | 説明 |
|---|---|---|---|
hall | はい | 非空 string(英字 value) | ホール識別子(例: island)。日別記事で利用可能なホールのみ |
date | いいえ | 空または YYYY-MM-DD | 対象日 |
kishu | はい | 非空 string(trim 後) | 検索対象の機種名 |
halls | いいえ | 英字スラッグの配列、またはカンマ区切り CSV | args 未登録。クエリに含まれる場合のみ Converter が template_halls とし L2 warm に使用。不正値は Converter で 400 |
出力(レスポンス)
成功時 data
| field | 型 | 説明 |
|---|---|---|
success | boolean | 常に true |
html | string | 機種検索結果セクション HTML 断片 |
assets | object | 動的読み込み用 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(意図マップ)。公開 CSS バンドル(daily-article-public-styles.css)が存在する場合、AssetUtil::PUBLIC_CSS_BUNDLE_SUPPRESSED_HANDLES に含まれる handle(本表のすべて)は assets.styles から除外され、初期 HTML 側で既読込済みとなる(バンドルあり時は styles が空配列になり得る)。
| handle | ファイル |
|---|---|
ranking-unit-data-css | templates/ranking_unit_data/ranking_unit_data.css |
create-ranking-kishu-data-css | templates/create_ranking_kishu_data/create_ranking_kishu_data.css |
tabs-package-css | templates/packages/Tabs/tabs.css |
colors-css | templates/daily_article_result/colors.css |
assets.scripts(JS handle 一覧)
assets.scripts は公開 CSS バンドル抑止の対象外。
| handle | ファイル |
|---|---|
tabs-package-js | templates/packages/Tabs/tabs.js |
ranking-details-js | templates/create_ranking_kishu_data/ranking-details.js |
権限・nonce
名前空間共通事項は API-一覧 を参照。本エンドポイントは AsyncLoadingHandler + WordPressAsyncLoadingPermissionChecker(nonce + IP レート制限)を使用する。差分はなし(共通のみ)。