您现在可以开启 管理 API 令牌过期 从您的应用 设置 页面中。此可选设置使您能够在 2027 年 4 月 1 日对现有公共应用开始强制执行之前,测试迁移到过期管理 API 令牌的流程。
变更内容
当您在应用的设置页面启用管理API令牌过期时,该设置将应用于该应用安装的所有商店,随后使用以下任一情况的GraphQL和管理REST API请求将会失败:
- 不过期的离线访问令牌
- 距离过期还有超过 24 小时的委托访问令牌
强制执行最多可能需要 30 分钟才能生效。启用该设置不会迁移或撤销现有令牌。
如果您遇到问题,可以关闭该设置。关闭它不会改变公共应用的 2027 年 4 月 1 日强制执行截止日期。该截止日期不适用于自定义应用或由商家创建的应用。
受影响对象
此设置适用于 Dev Dashboard 中的所有应用类型。仅当您为某个应用开启此设置后,它才会影响该应用。
2027 年 4 月 1 日的强制执行截止日期适用于现有公共应用。它不适用于自定义应用或由商家为其自己的商店创建的应用,尽管这些应用仍可以使用此设置来测试其对过期令牌的处理行为。
操作指南
您无需开启管理API令牌过期,但公开应用仍须满足迁移指南中描述的现有迁移截止日期。
如果您想提前验证迁移情况,您可以:
- 请使用管理API令牌过期迁移指南完成迁移,然后检查应用的GraphQL和REST日志以查找受影响的请求;Dev Dashboard会高亮显示过去14天内检测到的潜在令牌过期问题,尽管检测可能存在一天的延迟。
- 在Dev Dashboard中打开您的应用,进入设置,然后在管理API令牌过期卡片中选择开启,并确认您了解不符合令牌过期要求的请求将会失败。
- 等待最多 30 分钟让强制执行生效。然后检查应用的流程和日志中的被拒绝请求(包括来自后台作业的请求),以确认您的应用能正确处理过期的令牌。

