> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 增强 Ajax API 兼容性

> 允许第三方应用和自定义脚本接管加入购物车（Add to Cart）流程。

<div id="overview">
  # 概述
</div>

此设置有两个作用：

1. **对 Shopify Ajax 购物车调用进行排队。** 当多个脚本同时调用 Shopify 的 Ajax 购物车 API（`/cart/add`、`/cart/add.js`、`/cart/update.js`、`/cart/change.js`）时，Shopify 有时会丢失其中一个更改。Upcart 会强制这些调用逐个执行，确保每次更新都能生效。这是该设置的主要用途。
2. **退出加入购物车流程的管理。** 它还会禁用 Upcart 内置的加入购物车处理，这样需要完全控制该流程的应用或主题就不会与其冲突。

这两种行为绑定在同一个复选框上——你无法在启用请求排队的同时保留 Upcart 的加入购物车处理。

<div id="where-to-find-it">
  ## 在哪里找到它
</div>

打开购物车编辑器，前往 **Settings > Cart settings**，然后展开 **Advanced Settings**。\
找到 **"Enhanced Ajax API compatibility"**。

<div id="how-it-works">
  ## 工作原理
</div>

<div id="disabled-recommended">
  ### 禁用（推荐）
</div>

Upcart 保持对加入购物车流程的完全控制。这可以确保行为一致，并允许 Upcart 阻止其他应用或脚本覆盖购物车流程。

这是**大多数商店的推荐设置**。除非你遇到 Upcart 无法拦截来自主题或其他应用的加入购物车事件等特定问题，否则请保持禁用。

<div id="enabled">
  ### 启用
</div>

Upcart 将不再管理加入购物车流程。这允许其他应用、自定义 JavaScript 或你的主题在不受干扰的情况下修改购物车。

**仅在以下情况下启用此设置：**

* 你的商店使用非标准的 AJAX 购物车 API
* Upcart 无法拦截来自你的主题或其他应用的加入购物车事件
* 你需要第三方应用直接控制购物车行为

**启用后的重要权衡：**

* 其他应用可能会将顾客重定向到 Shopify 购物车页面，而不是打开 Upcart 抽屉
* 你可能会遇到重定向循环或意外的购物车行为
* Upcart 无法阻止外部应用更改购物车行为

**如果启用后导致重定向循环：**

1. 禁用此设置
2. 改用手动的 Upcart API（`upcartRegisterAddToCart`）
3. 参阅特定应用的集成指南（例如 [Replo](/zh/upcart/upcart_x_replo_landing_page_builder)）

<div id="testing">
  ## 测试
</div>

更改此设置后：

1. 点击 **Save**
2. 测试向购物车添加商品
3. 验证 Upcart 抽屉能正确打开
4. 检查你没有被重定向到 Shopify 购物车页面

如果启用后出现问题，请禁用该设置并联系支持团队获取替代方案。