| 特性 | 旧 | 新 | 影响 | ||
|---|---|---|---|---|---|
| 验证机制 | 基本验证（标题中的用户名和密码） | OAuth 2.0（基于令牌的身份验证） | 现有集成必须更新以处理令牌生成和更新。 | ||
| 强制请求 ID | 可选或不需要 | RequestId在每个请求中都是强制的 |
所有客户端应用程序都必须在每次调用中生成并包含唯一的请求 ID、 | 客户端应用程序中的错误处理逻辑可能需要修改。 | |
| 统一请求/响应结构 | 不同端点的不同格式 | 适用于所有读/写 API 的标准化 JSON 结构 | 客户端系统中的解析逻辑和数据模型可能需要更新。 | ||
| 增强的错误有效负载 | 最小化或通用的错误消息 | 包含代码、消息和提示的详细错误结构 | 客户应更新错误处理例程以利用新字段。 | ||
| 端点 URL 和参数 | 传统端点路径和参数名称 | 更新的端点路径和参数命名约定 | 必须审查和更新所有端点 URL 和请求有效负载。 |
