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.

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

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 consultar, filtrar, classificar, selecionar e expandir 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 Stats fornecem informações agregadas sobre diferentes entidades;

• Os métodos Account fornecem métodos de autenticação para o Orchestrator;

• Os métodos Queue são usados pelo Robô para acessar filas, enquanto o ponto de extremidade QueueDefinitions deve ser usado para sistemas externos via API;

• Os métodos QueueProcessingRecords oferecem informações estatísticas e agregadas sobre filas;

• Os recursos do RobotsService podem ser usados pelo Orchestrator para se comunicar com o Robô.