API-001-16 MailImage ホール横断バッチ取得

← API-一覧

概要

日別記事テンプレートの MailImage を 複数ホール分まとめて 非同期取得する（Issue #3608）。対象は DOM 上の .mail-image-placeholder のみ（先頭ホール SSR 成功分は除外。Issue #3609）。単体 GET（API-001-13）は部分失敗時のリトライ用に残す。共有テンプレート L2 は参照しないため L2 warm は行わない（Issue #3607 契約）。

入力（リクエスト）

param	必須	型・制約	説明
date	はい	YYYY-MM-DD	記事対象日
halls	はい	英字スラッグの配列、またはカンマ区切り CSV	取得対象ホール一覧（ページ上の全ホール）

出力（レスポンス）

成功時 data（リクエスト自体が処理できた場合）

field	型	説明
success	boolean	常に true（ホール単位の成否は items 側。部分失敗でもトップは true）
items	object	ホール英字スラッグ → { success, html?, error? }
assets	object	動的読み込み用 CSS/JS（バッチ全体で 1 回。mail-image.css / .js 等）

HTTP ステータス: 200

items の各要素

field	型	説明
success	boolean	当該ホールの描画成否
html	string	成功時のみ。MailImage ショートコード相当の HTML
error	object	失敗時のみ。{ "message": "..." }（クライアント向け文言）

失敗ホールはクライアントが既存の GET /async-mail-image でリトライする（優先度付きプール・Issue #3602）。

失敗・エラー条件

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

assets.styles（CSS handle 一覧）

handle	ファイル
mail-image-css	templates/mail_image/mail_image.css

assets.scripts（JS handle 一覧）

handle	ファイル
mail-image-js	templates/mail_image/mail_image.js

権限・nonce

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