关于 OData 和引用

Orchestrator API 实施基于 OData 协议。 OData（开放数据协议）是 ISO/IEC 批准的 OASIS 标准，它定义了一组用于构建和使用 RESTful API 的最佳实践。

开放数据协议 (OData) 支持创建基于 REST 的数据服务，该服务允许 Web 客户端使用简单的 HTTP 消息发布和编辑使用 URL 标识并在数据模型中定义的资源。 本规范定义了协议的核心语义和行为方面。

注意：Orchestrator OData 元数据端点的默认格式为 JSON。

有关协议原理和定义的更多信息，建议您查看 OData 官方文档。

逻辑资源和元数据

Orchestrator API 提供了自定义方法，用于查询有关在 Orchestrator 中注册的各种实体的统计信息。 每个逻辑资源都是一个 OData 实体。 所有实体（例如机器人、流程、队列）都具有属性、关系和操作。

可用操作

CRUD 操作

这些类型的操作最适用于逻辑资源。 CRUD 操作包括 GET、POST、PUT 和 DELETE 请求，但请注意，由于技术和业务原因，并非所有逻辑资源都使用所有这些动词。

请求数据

可以通过 OData 特定的参数，结合 GET 操作从特定资源请求特定信息。

它们使您能够查询、筛选、排序、选择和展开信息。 有关更多详细信息，请参阅 OData 官方文档。

自定义操作

Orchestrator API 中提供以下自定义操作和未绑定到逻辑资源的操作：

• Stats 方法 提供有关不同实体的聚合信息；
• 帐户方法 为 Orchestrator 提供身份验证方法；
• 机器人使用队列方法 来访问队列，而 QueueDefinitions 端点应通过 API 用于外部系统；
• QueueProcessingRecords 方法 提供有关队列的统计信息和聚合信息；

注意：您可以按天、小时和分钟请求数据，但仅当数据最多为 90 天时，系统才会显示数据。

• Orchestrator 可以使用机器人服务资源与机器人通信。