版本与升级 | AppForges Developer Center

请求与回显

公共REST路径使用 /v1/。请求日期版本的规范头是 X-AppForges-Api-Version；以 X-AppForges-Resolved-Api-Version 查看服务器实际解析的版本。

curl --fail-with-body "${APPFORGES_API_BASE_URL}/v1/users/me" \
  -H "Authorization: Bearer ${APPFORGES_ACCESS_TOKEN}" \
  -H "X-AppForges-Api-Version: 2026-04-01"

服务端当前兼容旧请求头 API-Version，新接入使用规范名。未显式指定时由服务端解析默认版本，不要假设应用创建日期提供独立schema隔离；检查实际回显。格式非法或未知版本可能返回400及 API_VERSION_INVALID / API_VERSION_UNKNOWN。

SDK与日期版本

SDK正式包版本 0.59.4 跟随protos/spec tag；它不是API日期版本。升级SDK前阅读对应包内CHANGELOG和公开release notes，运行自己的契约测试。

发布流水线比较共享API合同；0.x破坏变化必须提升MINOR，兼容PATCH仍需源码审阅。新增枚举值对穷举消费者也可能造成破坏，不能一律视为兼容。

弃用与迁移

实际网关在deprecated端点可发送标准 Deprecation，beta端点可发送 Warning。当前不承诺自动Sunset日期、日期到期统一410或固定六个月迁移窗口。版本头解析也不意味着服务器实现了任意历史schema转换。

升级前查看API Reference和Changelog，在staging用合法凭据完成测试，记录请求ID和版本回显，再部署客户端；保留已验证版本用于回退。应用Settings中的默认版本设置不能代替逐端点兼容性验证。

参见快速开始、错误与重试。