当API积极开发时，重要的是要保持版本之间的兼容性，并避免单个更改破坏数十个客户端集成的情况。我们实施全面的合同认证,使您能够监控更改并顺利更新API而不会给用户带来风险。
这在微服务体系结构，B2B集成和开源API产品中至关重要，其中不同的客户端使用不同版本的接口。
我们相信什么
| 对象 | 说明说明 |
|---|---|
| OpenAPI规范 | 储存每一份文件和合同 |
| Endpoint'ы | 我们将版本添加到URL （'/v1/', '/v2/'）,让我们保留后端兼容性 |
| 合同（Pact、Dredd） | 提交客户端与服务器之间的交互条件 |
| 数据模型 | 控制请求和响应结构的变化 |
我们如何实现
并行支持多个API版本- 在URL、标题或选项中明确指定版本
- 自动测试每个版本的合同（Pact、Postman、Jest、Dredd）
- 在Git中或通过CI/CD验证规格
- 每次更改时为客户提供的文档和changelog
优点
保证集成稳定性- 能够在没有"打破"客户风险的情况下发布新的菲奇
- 简化版本之间的迁移
- 明确的变更历史和合同控制
- 外部和内部开发团队的透明度
在哪里，特别重要
具有多种依赖性的微服务体系结构- 具有公共或B2B API的平台
- 具有长期合同的财务和付款系统
- 依赖于稳定API的移动应用程序
合同验证是API中可预测性和可信性的基础。我们实施允许您轻松更改和开发API的过程,同时保持各方的互操作性和透明度。
热门主题
主要主题
联系我们
请填写下方表格，我们会尽快回复您。