简体中文

版本与 OpenAPI

根据明确的 /api/v1 契约及可下载的 OpenAPI 文档开发。

API 版本

API 版本: URL 中的版本表示公共 API 契约。
Engine 发行版本: OpenAPI 中的 Engine 发行版本表示导出文档的实现版本；它不是资源的 expected_version。
资源版本: 业务资源版本用于并发控制，应从最新响应中获取。

OpenAPI

将下载的契约与集成测试一起保存。
更新集成时检查必填字段、允许的枚举值和响应架构。

请求与响应