版本控制

使用 Jasper 的 Postman Collection 简化您的开发。

确保我们的 API 可靠、稳健且稳定对我们来说至关重要。版本控制是任何 API 的关键部分，以避免重大更改，同时也能够兑现我们不断进步和改进服务的承诺。

以下是与弃用和版本控制相关的一些期望，以便您可以构建集成，而不必担心它将来会突然意外中断。

---

提前通知

如果我们需要取消某个端点或弃用公共 API 的任何功能，我们将至少提前 6 个月发出通知。

迁移指导

将提供详细的文档来帮助您迁移到新的、更新的端点。

非重大变更

Jasper 不认为以下更改具有破坏性，因此不需要提前通知：

• 新的 API 端点
• 新的只读或可选字段
• 标记为已弃用的端点或字段

例外情况

如果存在可能对其他客户的 API 产生负面影响的安全风险或问题，我们可能需要在不遵守上述通知期限的情况下弃用。仅在特殊情况下才会这样做，我们将尽快有效地进行沟通并提供支持。

版本控制系统

迄今为止，我们还没有做出任何向后不兼容的更改。对于任何向后不兼容的更改，我们计划将来通过基于日历的标头添加版本控制。

支持

我们致力于确保我们的客户能够充分过渡到新的 API 或功能，并很乐意提供技术支持来简化这种过渡。