English
版本与支持

版本、迁移与变更记录

理解 API、Schema、事件、应用版本和文档的兼容边界。

版本、迁移与变更记录

OpenAPI operation、Webhook payload、受控扩展 Schema 和应用 Manifest 分别版本化。已安装应用持续绑定获批的不可变应用版本,直到商家明确授权升级。新增可选字段可以兼容扩展;删除字段、改变语义、新增必需 scope 或改变签名都必须提供版本化迁移。

当前文档版本为 0.1.0:首次提供公开 Docus 站点、OpenAPI 漂移门禁、第三方 Nuxt Storefront、PKCE 指南、安装级 Webhook、库存防回环与自动发货对账。这是文档与静态示例证据,不代表生产 Provider 已认证。

升级前应比较已发布 OpenAPI 快照摘要和变更记录,在 sandbox 验证,轮换密钥时保留过渡窗口,并保留幂等状态。Sandbox 凭据和数据永远不能授权 production。

Copyright © 2026