自2026年12月1日起,所有新的自定义应用必须在GraphQL管理API和REST管理API请求中请求并使用过期的离线访问令牌。这一要求自2026年4月1日起已适用于新的公共应用。此次更新将该要求扩展至新创建的合作伙伴自定义应用和商家创建的应用。
如果您已经请求过有过期时间的离线令牌,可能无需更改您的应用。
变更内容
对于在2026年12月1日或之后创建的应用,Shopify要求对Admin API调用使用有过期时间的离线访问令牌:
- 您通过授权码授予(authorization code grant)或令牌交换获取的新离线令牌必须设置过期时间。
- 通过在您的令牌请求中包含expiring=1并存储和使用Shopify返回的刷新令牌,您可以请求一个过期的离线令牌。
- 通过客户端凭证授权获取的令牌在24小时后自动过期,因此该流程已符合此要求。
- 通过仅应用访问获取的令牌已符合此要求。
在2026年12月1日之前设置的现有自定义应用和商户创建的应用可以继续在其现有离线令牌上运行。
受影响对象
有过期时间的离线访问令牌的要求适用于:
- 在2026年12月1日或之后创建的自定义应用
- 在2026年12月1日或之后由商户创建的应用
以下情况不受此变更影响:
- 在2026年12月1日之前创建的自定义应用和商户创建的应用
- 公共应用,自2026年4月1日起已要求使用有过期时间的离线令牌
为何重要
有过期时间的离线访问令牌限制了泄露的令牌可被使用的时长。如果有过期时间的令牌发生泄露,除非您的应用刷新它,否则该令牌将在固定时间后失效。而非过期令牌会在应用卸载或您轮换应用密钥之前一直有效,从而增加了泄露带来的风险。
应对措施
如果您的应用使用令牌交换或授权码授予:
- 在您的离线访问令牌请求中包含expiring=1。
- 存储并使用 Shopify 返回的刷新令牌,以便在当前访问令牌过期时获取新的访问令牌。
- 如果您使用 Shopify 应用模板或库,请确保您使用的是最新版本,因为它们默认已经请求过期的令牌。
如果您的应用使用客户端凭证授权(client credentials grant):
- 您无需进行任何更改。该授权方式生成的令牌在 24 小时后自动过期。
有关设置详情和示例,请参阅管理API文档中的过期离线访问令牌指南:使用过期的离线访问令牌。

