Storefront API / Customer Account API が 2026-04 に。あわせて「API プロキシの常時有効化」と「バックエンド同意モードのデフォルト ON」という 2 つの破壊的変更が入る。アップグレード前に影響範囲の確認が必要。
Storefront API と Customer Account API の両方が 2026-04 バージョンに更新。(#3651)
proxyStandardRoutes オプションが削除。load context に storefront が無いと throw する。(#3649)
バックエンド同意モードがデフォルト ON。JS の _tracking_consent cookie をサーバー設定 cookie に置き換え。(#3649)
これまで任意で切り替えられた Storefront API プロキシが、常に有効になった。設定オプションが消え、前提条件も厳しくなる。
createRequestHandler の proxyStandardRoutes オプションで、標準ルートをプロキシするかどうかを制御できた。
プロキシは常に有効。proxyStandardRoutes は createRequestHandler から削除された。残したままだと修正が必要。
トラッキング同意（consent）の扱いが、クライアント JS の cookie からサーバー設定の cookieへ移行した。これがデフォルトになる。
_tracking_consent という JavaScript で設定していた cookie が置き換えられる。
Storefront API プロキシ経由でサーバーが cookie をセットする方式が標準。これが既定で有効。
Storefront API と Customer Account API の両方が 2026-04 に更新された。(#3651)
| 対象 | 新バージョン | 確認すべきこと |
|---|---|---|
| Storefront API | 2026-04 | 2026-04 changelog に記載の他の変更がストアフロントに影響しないか確認 |
| Customer Account API | 2026-04 | 2026-04 changelog に記載の他の変更を確認 |
proxyStandardRoutes を渡していたら削除する（オプションは廃止）。
storefront instance が必ず含まれるように。無いと request handler が throw する。
サーバー設定 cookie 前提に。_tracking_consent に依存した自前実装がないか確認。
proxyStandardRoutes は createRequestHandler から削除済み。切り替えはできず、常に有効が前提になる。(#3649)
load context に storefront instance が無いと request handler が throw。カスタムサーバーエントリは要点検。
バックエンド同意モードがデフォルト ON。_tracking_consent JS cookie をサーバー設定 cookie に置き換え。
同意 cookie は Storefront API プロキシ経由でセットされる。プロキシ常時有効化が同意モードの前提になる。
Storefront API / Customer Account API ともに 2026-04 に更新 (#3651)。2026-04 で入った API 個別の変更内容は本記事には記載なし。各 API の 2026-04 changelog を別途レビューする必要がある。
proxyStandardRoutes を使っていたり load context に storefront を入れていない箇所があると、上げた瞬間にエラーになる恐れ。createRequestHandler 呼び出し箇所を棚卸しし、廃止オプションを除去。load context に storefront instance が必ず入るよう修正してからアップグレード。_tracking_consent の JS cookie に依存した同意管理。クライアント JS 前提のため、SSR や同意状態の一貫性で扱いづらい。2026-04 に揃える。各ストアで 2026-04 changelog をチェックし影響を洗い出す。createRequestHandler と同意フローを点検してからアップグレードすること。」