WordPress REST APIへの画像アップロードが日本語ファイル名で落ちる——Content-Dispositionとlatin-1の罠新着!!

WordPress REST API のメディアアップロードで日本語ファイル名を渡すと UnicodeEncodeError で失敗する。HTTPヘッダが latin-1 で符号化される仕組みと、ASCIIセーフなファイル名への変換による回避策、そして失敗が下流で握りつぶされていた設計上の反省をまとめる。