服务对象与地域限制
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 为准。