Appearance
API-001-13 MailImage 非同期取得
概要
日別記事テンプレートの MailImage（メイン PNG + P-WORLD メール HTML）を非同期取得する。テンプレート経路では 先頭ホールは SSR（Issue #3609）、2 ホール目以降および SSR 失敗時の先頭ホールがプレースホルダとなり、orchestrator がバッチ／単体 GET で取得する。共有テンプレート L2（daily_link_list 等）は参照しない。
入力（リクエスト）
| param | 必須 | 型・制約 | 説明 |
|---|---|---|---|
hall | はい | 英字スラッグ（island 等） | 対象ホール |
date | はい | YYYY-MM-DD | 記事対象日 |
halls | いいえ | 英字スラッグの配列、またはカンマ区切り CSV | ページ全体のホール一覧（クライアント互換用。本エンドポイントでは未使用） |
出力（レスポンス）
成功時 data
| field | 型 | 説明 |
|---|---|---|
success | boolean | 常に true |
html | string | MailImage ショートコード相当の HTML（静止画既定・GIF 切替 UI を含む完成 HTML） |
assets | object | 動的読み込み用 CSS/JS（mail-image.css / mail-image.js 等） |
HTTP ステータス: 200
失敗・エラー条件
| 条件 | レスポンス形式 |
|---|---|
| バリデーションエラー | { "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 レート制限）を使用する。差分はなし（共通のみ）。