ADM-001-11 pworld_gif_backfill

← EP-一覧 · 共通前提

概要

外部 GIF のバックフィルを実行する。選択メール指定モードと、カーソル付きバッチモードがある。

POST パラメータ（2 モード）

A. 選択メール指定（mail_ids が非空のとき）

フィールド	説明
mail_ids	正の整数の配列（最大 10 件＝PworldGifBackfillLimits::MAX_BATCH_LIMIT）

この場合、MySQL ユーザー定義ロック（with_pworld_archive_mysql_run_lock）下で backfill_batch_for_mail_ids を実行。

B. バッチモード（mail_ids が空のとき）

フィールド	必須	説明
limit	○	1〜10（上記 MAX と一致）
after_mail_id	任意	非負整数。カーソルとして渡す

pworld_mail_archiveテーブルからデータ取得

カラム名	where	検索値
id	○	mail_ids または after_mail_id
processed_html

成功時 data

PworldGifBackfillService::backfill_batch / backfill_batch_for_mail_ids の戻りに、表示用 message をマージしたもの（merge_gif_backfill_result_with_message）。

論理名	物理名	型
表示用メッセージ	message	string
処理試行メール数	processed	int
成功数	success	int
失敗数	failed	int
残件数（全体）	remaining	int（早期中断時など取得できない場合はキー自体が無い場合あり）
続きがあるか	has_more	bool
次ページカーソル	next_after_mail_id	int
失敗スキップの有無	has_skipped_failures	bool