- Primeros pasos
- Autenticación
- Ámbitos y permisos
- API de gestión de plataformas

Guía de la API de Test Cloud
Descargar eventos
Descarga los eventos de auditoría como archivo CSV. Cada experiencia de registro proporciona puntos finales de descarga independientes.
Experiencia de registros unificados
La experiencia de registros unificados utiliza estos puntos finales de API y proporciona dos ámbitos:
- Nivel de organización:
/orgaudit_/ - Nivel de tenant:
/tenantaudit_/
Estas API descargan información de auditoría en los servicios de UiPath integrados en el marco unificado.
Punto final de API
Nivel de organización
GET {accessURL}/{org-name}/orgaudit_/api/query/downloadevents
Sustituye {accessURL} en todas las rutas de los puntos finales por la URL base de tu plataforma en la nube:
| Cloud Platform | URL de acceso |
|---|---|
| Test Cloud | https://cloud.uipath.com/ |
| Test Cloud Sector Público | https://govcloud.uipath.us/ |
| Test Cloud Dedicado | https://{customURL}.dedicated.uipath.com/ |
Nivel tenant
GET {accessURL}/{org-name}/{tenant-name}/tenantaudit_/api/query/downloadevents
Sustituye {accessURL} en todas las rutas de los puntos finales por la URL base de tu plataforma en la nube:
| Cloud Platform | URL de acceso |
|---|---|
| Test Cloud | https://cloud.uipath.com/ |
| Test Cloud Sector Público | https://govcloud.uipath.us/ |
| Test Cloud Dedicado | https://{customURL}.dedicated.uipath.com/ |
Ámbitos
Requiere uno de los siguientes ámbitos:
- PM.Audit
- PM.Audit.Read
Solicitar encabezados.
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
Para obtener el {access_token}, asegúrate de autenticarte a través de uno de los métodos descritos aquí.
Parámetros de consulta
| Parámetro | Tipo | Descripción |
|---|---|---|
from (opcional) | Datetime | Inicio del intervalo de tiempo |
to (opcional) | Datetime | Fin del intervalo de tiempo |
source (opcional) | Matriz [String] | Lista de orígenes de eventos |
target (opcional) | Matriz [String] | Lista de categorías |
type (opcional) | Matriz [String] | Enumerar todas las actividades |
userIds (opcional) | Matriz [String] | Lista de identificadores de usuario |
status (opcional) | Entero |
|
Respuesta
200 OK
Descarga un archivo .CSV que contiene los eventos de auditoría seleccionados.
Solicitud de ejemplo
Nivel de organización
curl --location 'https://cloud.uipath.com/{org-name}/orgaudit_/api/query/downloadevents?from=2024-12-24T00:00:00Z&to=2025-03-24T00:00:00Z&status=0' \
--header 'Authorization: Bearer {token}'
curl --location 'https://cloud.uipath.com/{org-name}/orgaudit_/api/query/downloadevents?from=2024-12-24T00:00:00Z&to=2025-03-24T00:00:00Z&status=0' \
--header 'Authorization: Bearer {token}'
Nivel tenant
curl --location 'https://cloud.uipath.com/{org-name}/{tenant-name}/tenantaudit_/api/query/events?status=0&from=2024-12-24T19%3A11%3A46.403Z&to=2025-03-24T19%3A11%3A46.403Z&source
=1bf33a0d-fbe0-4fe5-b7f6-c61379878989&source
=afef9b33-872c-4c10-9039-009866131e77&source=f51fa47f-a015-4b0b-b9c3-28caa3d00788
&source=3e5e8c49-5e7f-41cc-a2ec-c42f9deebb70&target=5c8402f9-0529-4317-8790-568842208620&target=19d7f55c-c580-4bec-b6f0-d5deab0b17f3&target=09d74792-21f4-4bc9-a650-9020f8811c32&type=a912d4d8-df39-44c7-b696-27c5660c06da&type
=a57e644c-2d80-4f40-ac3b-b7c934d0a510&userIds
=4120ea1c-5d2b-4287-ba6c-904c694d2767&userIds=a922809d-3956-4376-8406-4eb2d6d6b363' \
--header 'Authorization: Bearer {token}'
curl --location 'https://cloud.uipath.com/{org-name}/{tenant-name}/tenantaudit_/api/query/events?status=0&from=2024-12-24T19%3A11%3A46.403Z&to=2025-03-24T19%3A11%3A46.403Z&source
=1bf33a0d-fbe0-4fe5-b7f6-c61379878989&source
=afef9b33-872c-4c10-9039-009866131e77&source=f51fa47f-a015-4b0b-b9c3-28caa3d00788
&source=3e5e8c49-5e7f-41cc-a2ec-c42f9deebb70&target=5c8402f9-0529-4317-8790-568842208620&target=19d7f55c-c580-4bec-b6f0-d5deab0b17f3&target=09d74792-21f4-4bc9-a650-9020f8811c32&type=a912d4d8-df39-44c7-b696-27c5660c06da&type
=a57e644c-2d80-4f40-ac3b-b7c934d0a510&userIds
=4120ea1c-5d2b-4287-ba6c-904c694d2767&userIds=a922809d-3956-4376-8406-4eb2d6d6b363' \
--header 'Authorization: Bearer {token}'
Experiencia de registros clásica
Punto final de API
GET {accessURL}/audit_/api/auditlogs/download
Sustituye {accessURL} en todas las rutas de los puntos finales por la URL base de tu plataforma en la nube:
| Cloud Platform | URL de acceso |
|---|---|
| Test Cloud | https://cloud.uipath.com/ |
| Test Cloud Sector Público | https://govcloud.uipath.us/ |
| Test Cloud Dedicado | https://{customURL}.dedicated.uipath.com/ |
Ámbitos
Requiere uno de los siguientes ámbitos:
- PM.Audit
- PM.Audit.Read
Solicitar encabezados.
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
Para obtener el {access_token}, asegúrate de autenticarte a través de uno de los métodos descritos aquí.
Parámetros de consulta
| Parámetros de consulta | Tipo de datos | Descripción |
|---|---|---|
language (opcional) | String | Especifica el idioma de visualización disponible en forma acortada. Por ejemplo, en, fr, de, ja etc. |
size (opcional) | Int32 | Especifica el tamaño de la descarga. |
Respuesta
200 OK
La lista de eventos de auditoría se descargará en tu dispositivo en formato .csv.
Solicitud de ejemplo
Supongamos que has recopilado toda la información necesaria para crear la llamada a la API.
- Tu
{baseURL}es:https://cloud.uipath.com/{organizationName} - Tu
{access_token}es:1234(para consideraciones de longitud) - Puedes establecer los siguientes parámetros de consulta:
language=ensize= 13, para descargar las 13 primeras entradas.
La llamada debe parecerse al siguiente ejemplo (CURL):
curl --location --request GET ' https://cloud.uipath.com/{organizationName}/audit_/api/auditlogs/download?language=en&size=13' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
curl --location --request GET ' https://cloud.uipath.com/{organizationName}/audit_/api/auditlogs/download?language=en&size=13' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'