Sobre OData y referencias

La implementación de la API de Orchestrator se basa en el protocolo OData. OData (Open Data Protocol) es un estándar OASIS aprobado por ISO / CEI que define un conjunto de prácticas recomendadas para crear y consumir API REST.

El Open Data Protocol (OData) permite la creación de servicios de datos basados en REST, que permiten que los recursos identificados mediante URL y definidos en un modelo de datos sean publicados y editados por clientes web utilizando simples mensajes HTTP. Esta especificación define la semántica central y los aspectos de comportamiento del protocolo.

Nota: el formato predeterminado para los puntos finales de metadatos OData de Orchestrator es JSON.

Para obtener más información sobre los principios y definiciones de protocolo, recomendamos consultar la documentación oficial de OData.

Recursos lógicos y metadatos

La API de Orchestrator proporciona métodos personalizados para consultar estadísticas sobre varias entidades registradas en Orchestrator. Cada recurso lógico es una entidad de OData. Todas las entidades (como Robot, Proceso, Cola) tienen propiedades, relaciones y operaciones.

Operaciones disponibles

Operaciones CRUD

Estos tipos de operaciones están disponibles en la mayoría de los recursos lógicos. Las operaciones CRUD incluyen solicitudes GET, POST, PUT y DELETE, pero tenga en cuenta que no todos los recursos lógicos hacen uso de todos estos verbos debido a razones técnicas y comerciales.

Solicitar datos

Es posible solicitar información particular de un recurso particular, junto con las operaciones GET, mediante parámetros específicos de OData.

Le permiten consultar, filtrar, ordenar, seleccionar y expandir información. Puedes encontrar más detalles en la documentación oficial de OData.

Acciones personalizadas

Las siguientes acciones personalizadas y las que no están vinculadas a un recurso lógico están disponibles en la API de Orchestrator:

Los métodos de estadísticas proporcionan información agregada sobre diferentes entidades;
Los Métodos de cuenta proporcionan métodos de autenticación a Orchestrator;
El Robot utiliza losmétodos de colas para acceder a las colas, mientras que el punto final QueueDefinitions debe utilizarse en su lugar para sistemas externos a través de la API;
Los métodos de QueueProcessingRecords ofrecen información estadística y añaden información sobre las colas;

Nota: puedes solicitar datos por día, hora y minuto, pero solo se muestran si tienen un máximo de 90 días de antigüedad.