用途:帮助开发者在 Shopify 生态中调用各类 API,覆盖后台管理与自定义购物体验场景。
API 选择:Admin GraphQL API 为首选,适用于多数后台操作,功能与效率优于 REST;Admin REST API 适合简单资源管理或对接旧系统;Storefront API 用于构建无头商务等自定义购物前端,可匿名或使用公开访问令牌。
认证:Admin API 自定义应用使用访问令牌,请求头为 X-Shopify-Access-Token: <shpat_...>,地址形如 https://{shop}.myshopify.com/admin/api/{version}/{endpoint}。面向 App Store 分发应用走 OAuth 换取离线或在线令牌。Storefront API 使用公开令牌,请求头为 X-Shopify-Storefront-Access-Token。
主要接口:Admin GraphQL 端点为 POST https://{shop}.myshopify.com/admin/api/{version}/graphql.json,支持查询与变更操作,使用游标分页,需取 pageInfo.hasNextPage 与末尾 cursor,配合 after 参数翻页。Admin REST 端点为 https://{shop}.myshopify.com/admin/api/{version}/{resource}.json,通过 Link 响应头分页,多数资源应使用 page_info 而非 page 参数。Storefront 端点为 POST https://{shop}.myshopify.com/api/{version}/graphql.json。
限流:采用漏桶算法。REST 标准为每桶 40 次请求,每秒补充 2 次;GraphQL 按成本计,每桶 1000 点,补充速率随情况变化。可通过 REST 的 X-Shopify-Shop-Api-Call-Limit 头或 GraphQL 的 extensions.cost 检查用量,遇 429 应实现指数退避。
限制:具体版本号、端点细节与实际配额以官方文档为准;该资料未提供完整安装步骤、收费信息与更多示例。