shopify-rate-limits

用途：本技能用于处理 Shopify 的两套 API 速率限制体系，即 REST Admin API 的漏桶机制与 GraphQL Admin API 的计算查询成本机制，帮助避免 429 与 THROTTLED 错误。\n\n主要能力：REST 侧，标准计划桶容量 40 请求、泄漏速率 2/秒，Shopify Plus 为 80 请求、4/秒；通过 X-Shopify-Shop-Api-Call-Limit 头查看桶状态，满时返回 HTTP 429 和 Retry-After 头。GraphQL 侧，标准计划最大 1000 点、恢复速率 50 点/秒，Plus 为 2000 点、100 点/秒；响应 extensions.cost 中含 requestedQueryCost、actualQueryCost 和 throttleStatus。可据此实现成本感知限流器、429 重试与退避（优先用 Retry-After，否则指数退避加抖动，最大 30 秒），以及降低查询成本。\n\n使用方式：需了解 Shopify REST 与 GraphQL Admin API 及 @shopify/shopify-api 库。步骤包括理解两套限制、实现 GraphQL 成本感知限流、对 429 实现重试退避、精简字段与降低 first 分页大小。大批量数据导出可用 bulk query API 绕过速率限制，示例使用 p-queue 的 PQueue 与 bulkOperationRunQuery 变更。\n\n限制：资料未提供具体收费、价格或平台支持范围，也未给出完整类实现代码，仅给出方向指引；实际数值与行为以 Shopify 官方文档为准。