Storefront API 和 Ajax API 该用哪个

现象#

主题要做一个加购交互，不知道该调 /cart/add.js 还是 Storefront GraphQL。

原因#

• Ajax API 基于 cookie 会话，仅在店铺域名下可用
• Storefront API 用 token，适合 Hydrogen 与外部站点
• 两者购物车不互通（Ajax 用 cookie cart，Storefront 用 cart ID）

处理步骤#

1. 主题内简单加购、改数量 → 用 Ajax API，天然带会话
2. Headless、外部站点、需要精细查询 → 用 Storefront API
3. 同一项目不要混用两套购物车，否则数量对不上
4. Hydrogen 项目统一 Storefront API + cart handler

验收标准#

选定一套后购物车状态单一可信，加购与结账流程一致，无数量错乱。