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 的应用列表中,找错入口就会一直空手
处理步骤#
- 打开
Settings → Apps and sales channels → Develop apps,新建或选中一个自定义应用 - 进
Configuration → Storefront API scopes,勾选unauthenticated_read_product_listings等实际需要的项并保存 - 点
Install app完成安装,再进API credentials复制 Storefront API access token - 若走 Headless,改从
Sales channels → Headless对应 storefront 的 Storefront API 区域取 public token - 用 curl 向
https://{shop}.myshopify.com/api/2026-07/graphql.json发{ shop { name } }验证
验收标准#
同一请求返回 200 且 data.shop.name 有值;把同一个令牌贴到 Admin 端点则应返回 401,说明取的是 Storefront 令牌。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。