shopify-api

用途：为 Shopify 应用与主题开发提供 API 集成指导，适用于调用 GraphQL/REST Admin API、实现 OAuth 2.0 认证、以 Storefront API 构建无头电商、在主题中用 Ajax API 操作购物车、注册 Webhook 处理事件，以及处理速率限制与 API 错误。

主要能力：

1. GraphQL Admin API：端点 POST https://{store}.myshopify.com/admin/api/2025-10/graphql.json，请求头 X-Shopify-Access-Token 与 Content-Type: application/json；含商品查询、productCreate/productUpdate、metafieldSet 等变更示例。
2. REST Admin API：基址 https://{store}.myshopify.com/admin/api/2025-10/，含商品、订单、客户等端点示例。
3. OAuth 2.0：授权请求、回调校验 HMAC、用 code 换取 access_token 的完整流程。
4. 速率限制：GraphQL 按点数计费，每秒最多 50 点，桶以 50 点/秒补充；通过 X-Shopify-GraphQL-Admin-Api-Call-Limit 响应头查看用量，配合指数退避重试。
5. Storefront API：端点 POST https://{store}.myshopify.com/api/2025-10/graphql.json，含商品查询与 cartCreate、cartLinesAdd 等购物车操作。
6. Ajax API（仅主题）：/cart.js、/cart/add.js、/cart/change.js、/cart/clear.js、/cart/update.js。
7. Webhook：注册订阅并校验 x-shopify-hmac-sha256，需在 5 秒内响应。

使用方式：按需选择 API 类型，携带对应访问令牌发起请求；GraphQL 用游标分页（pageInfo.hasNextPage/endCursor）遍历数据；对错误检查 errors 与 userErrors。

适用场景：自定义应用开发、无头店面、主题购物车交互、事件驱动集成。

限制：资料未提供具体收费、价格、平台支持范围与效果数据；示例基于 API 版本 2025-10，实际使用需以官方最新文档为准。