用途:为 Shopify 各类 API 集成提供专家级指导,适用于调用 GraphQL/REST Admin API、实现 OAuth 2.0 应用认证、以编程方式获取商品/集合/订单/客户数据、使用 Storefront API 构建无头电商、在主题中实现 Ajax 购物车操作、设置 Webhook 事件处理、处理限流与 API 错误,以及用 Node.js、Python 等语言构建自定义集成。
主要能力:
- GraphQL Admin API:端点 POST https://{store}.myshopify.com/admin/api/2025-10/graphql.json,请求头 X-Shopify-Access-Token 与 Content-Type: application/json;提供商品查询、分页(pageInfo/endCursor)、productCreate、productUpdate、metafieldSet 等变更示例。
- REST Admin API:基础地址 https://{store}.myshopify.com/admin/api/2025-10/,含商品、订单、客户的获取与创建、更新端点示例。
- OAuth 2.0:授权请求、回调 HMAC 校验、用 code 换取 access_token 的完整流程与 Node.js 示例。
- 限流:GraphQL 采用积分制,每秒最多 50 点、按 50 点/秒回填;通过 X-Shopify-GraphQL-Admin-Api-Call-Limit 响应头检查用量,并给出指数退避重试逻辑。
- Storefront API:端点 POST https://{store}.myshopify.com/api/2025-10/graphql.json,请求头 X-Shopify-Storefront-Access-Token;含商品查询与 cartCreate、cartLinesAdd 等购物车操作。
- Ajax API(仅主题):/cart.js、/cart/add.js、/cart/change.js、/cart/clear.js、/cart/update.js 的购物车读取、添加、修改、清空与属性更新。
- Webhook:常见主题(products、orders、customers、carts、inventory_levels、app/uninstalled),GraphQL 注册示例,以及 Node.js/Express 中校验 x-shopify-hmac-sha256 并在 5 秒内响应的处理方式。
使用方式:按需调用对应 API 端点并携带访问令牌;GraphQL 优先于 REST 以提升效率;仅请求必要字段;对分页使用游标循环;对 429 采用指数退避;Webhook 必须校验 HMAC 并快速响应。
适用场景:自定义应用开发、无头电商前端、主题内购物车交互、订单与库存事件同步、数据批量拉取。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;示例基于 API 版本 2025-10,实际使用需以官方最新文档为准;访问令牌须安全存储,不可暴露于客户端代码,并应使用最小必要权限范围。