PuppyIP 资源中心
跨境电商开发 5 分钟 发布于 2026-11-18

Shopify Customer Account API 返回 429?按顾客共享限流排查

Shopify Customer Account API 返回 HTTP 429 且错误码为 THROTTLED 时,先读 Retry-After,再暂停这家店这位顾客的请求。每位顾客每分钟 3,000 次请求上限由同一店铺内所有调用该 API 的应用共享。HTTP 200 也可能带 THROTTLED,常对应 GraphQL 查询成本上限。

Shopify Customer Account API HTTP 429 Retry-After

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 按店铺和顾客计算请求次数。每个应用没有独享 3,000 次。
  • HTTP 429 加 THROTTLED 对应顾客请求次数限流。Retry-After 表示重试前需等待的秒数。
  • HTTP 200 加 THROTTLED 对应查询成本限流。读取 GraphQL 错误和响应中的成本信息。
  • 排查时核对重复刷新、分页、并发组件和失败重试,避免同一批任务一起恢复。

这 3,000 次请求怎么算?

Shopify 于 2026 年 10 月 7 日公布了 Customer Account API 的请求上限。平台按「店铺 + 顾客」计算每分钟的请求次数,合计同一店铺内所有调用该 API 的应用。原有的 GraphQL 成本限制仍同时生效。

假设同一店铺有两个应用为同一位顾客加载资料,两边的请求都会计入该顾客的共享上限。你在自己的日志里看到的调用量只覆盖自己的应用。正常买家流量通常低于这项上限,出现告警时先检查有没有异常频率或重试叠加。

同样是 THROTTLED,怎么看是哪种限流?

先看 HTTP 状态,再解析 GraphQL 响应。HTTP 429 搭配 THROTTLED 表示这位顾客在店内的请求次数触及上限。Retry-After 响应头给出重试前应等的秒数。

如果 HTTP 为 200,但 GraphQL 错误码是 THROTTLED,Shopify 文档将其列为查询成本限流。检查响应 extensions 中的 requestedQueryCost、actualQueryCost 等可用信息,再核对查询字段、分页大小与调用频率。处理成功结果之前,也要读错误字段。

收到 429 后怎样恢复请求?

暂停本应用中同一店铺、同一顾客的后续请求,按 Retry-After 等待。假设响应头值为 60,就至少等 60 秒再尝试。把重复读取合并,限制同时发出的请求,恢复时逐步放行,避免页面各组件同时重试。

对读取与写入分别决定是否重试。对于写入任务,先确认操作结果和重试条件,以免重复提交。自己的队列只能约束本应用的调用,仍需处理其他应用共享额度时返回的 429。

到哪里找触发限流的动作?

用脱敏日志按店铺、顾客和时间归并,保留操作名、HTTP 状态、GraphQL 错误码和可用的 Retry-After 值。先找最早一批失败,再回看同时段是否有轮询、组件重复加载、分页循环或多次恢复请求。

如果只有一种页面交互反复触发,先复用页面已经取得的数据或合并同一用户动作的重复读取。修改后,在获授权的环境观察该交互的请求次数和错误变化,不需要在生产主动打满额度。

资料来源

常见问题

Shopify Admin API 也按这个 3,000 次上限判断吗?

这份公告讨论的是 Customer Account API。若错误来自 Admin API,按实际调用的 API 和 Shopify 对应文档判断。

可以从自己的日志精确算出顾客还剩多少次数吗?

本应用的日志只能看到自己的请求,而额度跨应用共享。遇到 429 时以 Shopify 返回的 Retry-After 为准。