用途:Shopify Storefront API 是公开的 GraphQL API,提供对商店商品、集合、购物车与结账的读写访问,用于构建无头前端,如 Next.js、Remix/Hydrogen 或任意 JS 框架,也适用于 React Native、Flutter 移动应用及在非 Shopify 站点嵌入购买组件。
主要能力:查询商品与集合(支持分页、排序、图片、变体、价格区间)、创建和管理购物车(cartCreate、cartLinesAdd)、获取 checkoutUrl 跳转结账、预测搜索(predictiveSearch)、通过 @inContext 指令返回本地化价格。
使用方式:在 Shopify 后台创建 Storefront Access Token(不使用 shpat_ 前缀),安装官方客户端 npm install @shopify/storefront-api-client,用 createStorefrontApiClient 配置 storeDomain、apiVersion 与 publicAccessToken;服务端可使用 privateAccessToken 获得更高限额。通过 storefront.request 发送 GraphQL 查询与变更,购物车 ID 可存入 localStorage 或 cookie 以跨会话保持。
适用场景:自定义前端商品列表与详情页、移动端购物应用、嵌入式购买按钮、Hydrogen 无头商店、需要实时库存与价格但不想使用 Admin API 的场景。
限制与注意:Storefront API 按商店限流,公开令牌约 100 请求/秒,私有令牌约 1000 请求/秒;应使用游标分页而非偏移;需检查商品与变体的 availableForSale;所有变更需处理 userErrors;移动端 Safari 结账跳转应在用户手势中执行。具体价格、套餐与平台支持以官方资料为准,本资料未提供。