Skip to content

API-001-9 ヒートマップ(簡易)非同期取得 ​

← API-一覧

概要 ​

日別記事結果のヒートマップ(簡易表示)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型説明
successbooltrue
htmlstringheat-map-simple-group を含む HTML 断片
assetsobject動的読み込み用 CSS/JS(他 async と同型)

失敗・エラー条件 ​

条件レスポンス形式
バリデーションsuccess: false, HTTP 400
サーバーエラーsuccess: false, HTTP 500, error.message

権限・nonce ​

共通のみ(API-一覧 の PermissionChecker / レート制限に準拠)。