Acceso a la API

Información general

La API abierta del servicio de datos te permite gestionar los recursos del servicio de datos de UiPath desde una aplicación externa de su elección, y lo hace permitiéndote autorizar la aplicación externa sin compartir ninguna credencial, a través del marco de autorización Oauth 2.0.

Learn how to register the external application in UiPath Automation Suite.

Permisos de API

Para utilizar el OpenAPI de Data Service, debes conceder permisos de API a la aplicación externa.Estos permisos de API se conocen como ámbitos, y hay tres tipos para Data Service:

• DataService.Schema.Read: este Ámbito de usuario permite a tu aplicación externa leer el esquema de Data Service de un inquilino, y depende de los permisos del usuario.
• DataService.Data.Read: este Ámbito de usuario permite a tu aplicación externa leer los datos de Data Service de un inquilino, y depende de los permisos del usuario.
• DataService.Data.Write: este Ámbito de usuario permite a tu aplicación externa editar los datos de Data Service de un inquilino, eliminar y crear nuevos datos, y depende de los permisos del usuario.

Learn more about the user roles and permissions in Data Service.

Descargar la especificación de OpenAPI

Con tu aplicación externa y los permisos de usuario establecidos, es hora de descargar la especificación de OpenAPI de los datos de Data Service de un inquilino.Abre el menú de la parte superior derecha de la pestaña Data Service del inquilino > Acceso a API > Descargar archivo OpenAPI (JSON).

This will get you the OpenAPI 3.0 specifications of your tenant's Data Service entities, in JSON format. Clicking **Copy OpenAPI link** copies the API endpoint that generates the tenant's Data Service OpenAPI specification.

Autorizar las llamadas a API

Autoriza tu aplicación externa para que utilice el OpenAPI de Data Service creando un token de acceso para tu aplicación externa.el App ID y el App Secret que se generaron en el registro de la aplicación externa. El método de autorización depende del tipo de aplicación (confidencial o no confidencial).

Más información sobre los métodos de autorización para aplicaciones externas.

Puntos de conexión de API

OAuth2.0 authorization framework helps you generate a access token that allows your external application to make REST API calls to Data Service endpoints, for a limited time (one hour). To continue calling the APIs you need to generate a new access token or request a refresh token.

Un punto final de la API de Data Service tiene la siguiente sintaxis:

• Método HTTP + BaseURL + La categoría de recursos + La entidad de Data Service + La operación + Variables de ruta y parámetros de consulta

  

  Importante:

  In the Automation Suite-deployed Data Service, each active connection can have only one active file upload API call.

  Para evitar encontrarse con esta limitación de API, asegúrese de pasar el encabezado Connection: close en su solicitud.

  Ejemplo de entidad de Data Service

  Para describir cada cuerpo de solicitud/respuesta de la API, utilizamos los campos de entidad Olimpiadas creados en Data Service. Mientras documentamos el punto final genérico, como Get Entity Records, su punto final contiene el nombre exacto de su entidad (por ejemplo, Get Olympics Records). Los cuerpos de respuesta y solicitud incluyen todos los campos de su entidad, replicando la estructura de la misma.

  

  Además, vamos a profundizar en cada punto final y descubrir cómo se puede hacer un buen uso de él.