版本控制
使用 Jasper 的 Postman Collection 简化您的开发。
确保我们的 API 可靠、稳健且稳定对我们来说至关重要。版本控制是任何 API 的关键部分,以避免重大更改,同时也能够兑现我们不断进步和改进服务的承诺。
以下是与弃用和版本控制相关的一些期望,以便您可以构建集成,而不必担心它将来会突然意外中断。
提前通知
如果我们需要取消某个端点或弃用公共 API 的任何功能,我们将至少提前 6 个月发出通知。
迁移指导
将提供详细的文档来帮助您迁移到新的、更新的端点。
非重大变更
Jasper 不认为以下更改具有破坏性,因此不需要提前通知:
- 新的 API 端点
- 新的只读或可选字段
- 标记为已弃用的端点或字段
例外情况
如果存在可能对其他客户的 API 产生负面影响的安全风险或问题,我们可能需要在不遵守上述通知期限的情况下弃用。仅在特殊情况下才会这样做,我们将尽快有效地进行沟通并提供支持。
版本控制系统
迄今为止,我们还没有做出任何向后不兼容的更改。对于任何向后不兼容的更改,我们计划将来通过基于日历的标头添加版本控制。
支持
我们致力于确保我们的客户能够充分过渡到新的 API 或功能,并很乐意提供技术支持来简化这种过渡。
最后修改时间: 9 个月前