- Primeros pasos
- Instalación y configuración
- Uso de Data Service
- Referencia
- Ejemplos y Tutoriales
Acceso a la API
Data Service Open API te permite gestionar los recursos de UiPath® Data Service desde una aplicación externa de tu 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.
Aprende a registrar la aplicación externa en UiPath® Automation Cloud.
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.
Más información sobre los roles de usuario y permisos en Data Service.
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).
Esto te obtendrá las especificaciones de OpenAPI 3.0 de las entidades de Data Service de tu inquilino, en formato JSON.Al hacer clic en el enlace Copiar OpenAPI, se copia el punto de conexión de API que genera la especificación de OpenAPI del inquilino.
Para acceder a los recursos de ámbito de usuario de Data Service, autoriza tu aplicación externa con uno de los siguientes métodos:
-
Código de autorización (para aplicaciones externas confidenciales)
-
Código de autorización con PCKE (para aplicaciones externas no confidenciales)
El marco de autorización OAuth2.0 te ayuda a generar un token de acceso que permite a su aplicación externa realizar llamadas a la API REST a los puntos finales de Data Service durante un tiempo limitado (una hora). Para seguir llamando a las API es necesario generar un nuevo token de acceso o solicitar un token de actualización.
Un punto final de la API de Data Service tiene la siguiente sintaxis:
-
Método HTTP + BaseURL + La categoría del recurso + La entidad de Data Service + La operación + Variables de ruta y parámetros de consulta
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, comoGet 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.