Appearance
API-001-9 ヒートマップ(簡易)非同期取得
概要
日別記事結果のヒートマップ(簡易表示)HTML を非同期で取得する。初期 HTML ではプレースホルダーのみ出力し、本エンドポイントで差枚・回転の簡易ヒートマップを返す。
完成 HTML は遅延ブロック Transient(daily_article_block_html_v1_{Y-m-d}_{gen}_heatmap_simple_{hall}_pc。{gen} は世代トークン、PUB-001 参照)に get/set する。ビューポート区分は extra に載せる(当面 UI REST / warm / ページ stitch は pc のみ)。ヒートマップ詳細(API-001-2)はキャッシュしない。
入力(リクエスト)
| param | 必須 | 型・制約 | 説明 |
|---|---|---|---|
hall | はい | 非空 string | ホール識別子(例: island) |
date | いいえ | YYYY-MM-DD | 対象日 |
出力(レスポンス)
成功時 data
| field | 型 | 説明 |
|---|---|---|
success | bool | true |
html | string | heat-map-simple-group を含む HTML 断片 |
assets | object | 動的読み込み用 CSS/JS(他 async と同型) |
失敗・エラー条件
| 条件 | レスポンス形式 |
|---|---|
| バリデーション | success: false, HTTP 400 |
| サーバーエラー | success: false, HTTP 500, error.message |
権限・nonce
共通のみ(API-一覧 の PermissionChecker / レート制限に準拠)。