Sobre OData e referências

A implementação da API do Orchestrator é baseada no protocolo OData. OData (Open Data Protocol) é um padrão OASIS aprovado pela ISO/IEC que define um conjunto de melhores práticas para construir e consumir APIs RESTful.

O Open Data Protocol (OData) permite a criação de serviços de dados baseados em REST, que permitem que recursos, identificados usando URLs e definidos em um modelo de dados, sejam publicados e editados por clientes Web usando mensagens HTTP simples. Esta especificação define a semântica central e os aspectos comportamentais do protocolo.

O formato padrão para o ponto de extremidade de metadados OData do Orchestrator é JSON, e o URL de metadados é https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/odata. Para alterar o formato padrão para XML, anexe /?$format=xml a esta URL.

Para obter mais informações sobre princípios e definições de protocolo, recomendamos verificar a documentação oficial do OData.

Observação: buscamos a conformidade com o padrão OData, mas não podemos garanti-la. Embora o padrão exija que o ponto de extremidade de metadados deva retornar o formato XML por padrão, retornamos JSON para compatibilidade histórica.

Recursos lógicos e metadados

A API do Orchestrator fornece métodos personalizados para consultar estatísticas sobre várias entidades registradas no Orchestrator. Cada recurso lógico é uma entidade OData. Todas as entidades (como Robô, Processo, Fila) têm propriedades, relacionamentos e operações.

Operações disponíveis

Operações CRUD

Esses tipos de operações estão disponíveis na maioria dos recursos lógicos. As operações CRUD incluem solicitações GET, POST, PUT e DELETE, mas observe que nem todos os recursos lógicos usam todos esses verbos por motivos técnicos e comerciais.

Solicitando Dados

É possível solicitar informações específicas de um recurso específico, em conjunto com operações GET, por meio de parâmetros específicos do OData.

Eles permitem que você consulte, filtre, classifique, selecione e expanda informações. Mais detalhes podem ser encontrados na documentação oficial do OData.

Ações Personalizadas

As seguintes ações personalizadas e ações que não estão vinculadas a um recurso lógico estão disponíveis na API do orquestrador:

• Os métodos estatísticos fornecem informações agregadas sobre diferentes entidades;
• Os métodos de conta fornecem métodos de autenticação ao orquestrador;
• Os métodos Queues são usados pelo Robot para acessar as filas, enquanto o endpoint QueueDefinitions deve ser usado para sistemas externos via API;
• Os métodos QueueProcessingRecords oferecem informações estatísticas e agregadas sobre as filas;

• Os recursosRobotsService podem ser usados pelo Orchestrator para se comunicar com o Robot.