Estructura de URL de punto final de la API

En esta sección, puede aprender a construir solicitudes de API entendiendo la estructura de URL de los puntos finales de UiPath®.

URL base

La URL base es el punto de partida para todas las solicitudes de API. Sirve como base para construir la URL del punto final. La URL base es https://govcloud.uipath.us.

Punto de entrada

api: significa el punto de entrada a los recursos de gestión de la plataforma API, por ejemplo ​/api​/Group​/.

RutaDeRecurso

La ruta del recurso especifica el recurso o la operación exacta que deseas realizar. Puede incluir palabras clave como Grupo, Cuenta de UiPath Robot, Configuración, dependiendo del propósito de la solicitud.

Parámetros de ruta

Los parámetros de ruta se utilizan para pasar los valores dinámicos a un punto final de la API. Estos valores ayudan a identificar recursos específicos que son relevantes para la solicitud de la API. Por ejemplo, ​/Group​/{partitionGlobalId}​/{groupId}

partitionGlobalId: el ID de la organización.

groupId: el ID del grupo.

Parámetros de consulta

Los parámetros de consulta son parámetros adicionales adjuntos a la URL para proporcionar más contexto o filtros para los datos solicitados. A menudo van precedidos de un ? y separados por símbolos &. Por ejemplo, puedes utilizar parámetros de consulta para especificar los criterios de filtrado o las instrucciones de paginación.

Ejemplo

Al juntar todos los componentes, una URL para un recurso específico de la organización puede tener el siguiente aspecto https://govcloud.uipath.us/{organizationName}/{tenantName}/identity_/api/group/{partitionGlobalId}​/{groupId}.

Una URL para un recurso específico de tenant puede tener este aspecto: https://govcloud.uipath.us/{organizationName}/{tenantName}/orchestrator_/odata/Assets.