Shopify API 2025-10版将于10月16日15:00 UTC停止可访问

Shopify 的 API 版本按季度发布，每个稳定版至少支持 12 个月，相邻版本之间至少有 9 个月的重叠期。根据官方版本时间表，2025-10 稳定版于 2025 年 10 月 1 日发布，可访问至 2026 年 10 月 16 日 15:00 UTC，此后状态变为 Unsupported。2026-10 版已于 10 月 1 日成为最新稳定版，可访问至 2027 年 10 月 16 日 15:00 UTC。

当应用请求的版本不可访问时，Shopify 会前滚（falls forward），改用最旧的仍可访问的稳定版本来响应请求。例如，针对已退役的 2024-10 版本的请求，会由最旧的仍可访问稳定版本来处理。API 响应中会包含 X-Shopify-API-Version 响应头，反映实际用于完成请求的版本；如果它与请求的版本不一致，说明应用正在使用一个不可访问的版本，Shopify 已前滚到默认版本。Webhook 负载的版本化方式与 API 响应相同，Webhook 也会包含 X-Shopify-Api-Version 响应头以确认所用版本。

Shopify 建议每季度更新到最新稳定版，并始终在请求中指定版本。官方 Shopify 库或 Storefront SDK 会自动处理版本配置。Shopify CLI 会阻止部署到超过 12 个月的旧版本。

如果应用在升级截止日期后继续使用不受支持的资源，会被从 Shopify App Store 下架，用户至少七天无法安装该应用，同时应用会在开发者后台收到警告。弃用信息会通过开发者后台的应用警报、GraphiQL Explorer 等 API 客户端工具中的弃用警告、开发者更新日志以及 API 参考文档等渠道传达。