读取我

Orchestrator API 规范说明，包括 OpenAPI 3.0 更新和先前 Swagger 2.0 规范的弃用时间表。

重要提示：

Orchestrator 默认 API 规范符合 OpenAPI 3.0。先前的规范（V20，基于 Swagger 2.0）已弃用，为了保持向后兼容性，在有限时间内仍可用。有关确切日期，请参阅下方的弃用时间线。迁移到新规范后，所有基于新 JSON 定义重新生成的 API 客户端都必须重新调整。

如果您计划将我们的 API 与您的客户端集成，则需要了解 API 规范、JSON 架构或 API 端点可能发生的更新和更改。

以下列表提供了有关 API 规范更改的信息和建议。如果您有其他疑问，请联系我们的支持团队。

弃用时间表

交付模式	已弃用	已删除
Automation Cloud	2026 年 8 月	2026 年 9 月
Automation Suite	2.2610 版本	2.2610 版本

有关 Swagger 更改的信息和建议

1. Swagger JSON 文档中表示的 JSON API 描述可以随时更改。 但是，它将描述相同的基础 API，以确保向后兼容性。
2. Swagger 界面和相应的 JSON 是根据当前端点生成的，并且我们始终发布最新版本。 为确保向后兼容性，我们支持相同的请求结构。
3. 作为运行时生成的 API 客户端的替代方法，请使用固定时或编译时 API 客户端。 这样做可以减少依赖关系，并防止在 API 或 Swagger 定义发生更改时进行重大自动化更新。
4. 标记为已弃用的项目在限定时间内可用，之后将从 Swagger 定义和 JSON API 中删除这些项目。
5. 每当某些 API 在内部发生更改时，都会发布新的 Swagger API 版本。 API 版本号不会影响客户端 API 的使用。 我们不建议依赖 API 版本控制。

API 示例

现有 Orchestrator 参考文档中提供的示例描述了复杂的场景和端点。

您可以在包含最新更新的 Swagger JSON 中查看所有可用的 API。