Shopify Storefront API

Shopify 后台在哪里创建 Storefront API 令牌

现象#

在后台 Settings 里翻遍 Apps and sales channels,只看到 Admin API 的 shpat_ 令牌,找不到 X-Shopify-Storefront-Access-Token 要用的那一串;拿 Admin token 请求 Storefront 端点直接 401 [API] Invalid API key or access token。

原因#

  • Storefront 令牌是独立凭证,只能由带 unauthenticated scope 的应用或 Headless 渠道签发,Admin API 页面不展示
  • 自定义应用一个 unauthenticated 权限都没勾时,创建令牌的请求会直接失败,界面上看起来像按钮没反应
  • 每个店铺每个应用最多 100 个有效 StorefrontAccessToken,超限后新建会被拒绝且不提示具体原因
  • Headless 渠道的令牌在 Sales channels 里,不在 Settings 的应用列表中,找错入口就会一直空手

处理步骤#

  1. 打开 Settings → Apps and sales channels → Develop apps,新建或选中一个自定义应用
  2. 进 Configuration → Storefront API scopes,勾选 unauthenticated_read_product_listings 等实际需要的项并保存
  3. 点 Install app 完成安装,再进 API credentials 复制 Storefront API access token
  4. 若走 Headless,改从 Sales channels → Headless 对应 storefront 的 Storefront API 区域取 public token
  5. 用 curl 向 https://{shop}.myshopify.com/api/2026-07/graphql.json 发 { shop { name } } 验证

验收标准#

同一请求返回 200 且 data.shop.name 有值;把同一个令牌贴到 Admin 端点则应返回 401,说明取的是 Storefront 令牌。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。