Comprobar la exclusividad del nombre de la aplicación

Referencia de la API para comprobar si el nombre de enrutamiento de una aplicación implementada es único dentro de la organización.

Comprueba si un nombre de enrutamiento determinado es único para las aplicaciones implementadas dentro de la organización. Si el nombre ya está en uso, la respuesta también devuelve la aplicación implementada que lo contiene.

Punto final de API

GET <BaseURL>/models/deployed/apps/uniquename/check/{routingName}

Consulta la URL base para la ruta del punto final raíz.

Solicitar encabezados.

Encabezado	Valor
Autorización	Portador <your-access-token>
X-UiPath-Internal-TenantId	<tenant_id>

Nota:

Reemplaza todos los valores entre corchetes angulares <...> con sus valores de caso de uso correspondientes.

El <access_token> es el que recibiste al autorizar la aplicación externa con el ámbito Apps o Apps.Read . Está disponible durante 1 hora, luego debes generar uno nuevo o solicitar un token de actualización.

Variables de ruta

Variable de ruta	Tipo de datos	Descripción
NombreDeEnrutamiento (obligatorio)	string	El nombre de enrutamiento para comprobar la exclusividad.

Respuesta

200 OK

Si el nombre de enrutamiento está disponible, occupiedBy es null:

{
  "isUnique": true,
  "occupiedBy": null
}

Si el nombre de enrutamiento ya está en uso, occupiedBy devuelve la aplicación implementada que lo contiene:

{
  "isUnique": false,
  "occupiedBy": {
    "id": "string",
    "systemName": "string",
    "title": "string",
    "deploymentTitle": "string",
    "deploymentDescription": "string",
    "deployVersion": 1,
    "semVersion": "string",
    "dateDeployed": "string",
    "deploymentFolder": {
      "key": "string",
      "id": 1,
      "displayName": "string",
      "fullyQualifiedName": "string"
    },
    "isAppPublic": false,
    "isLatestVersion": true,
    "isResourceActivated": true,
    "routingName": "string"
  }
}

Campo	Tipo de datos	Descripción
Es único	boolean	true si el nombre de enrutamiento está disponible, false si ya está en uso.
Ocupado por	object	La aplicación implementada que contiene el nombre de enrutamiento. null cuando isUnique es true. También puede ser null cuando isUnique es false, si la aplicación que contiene el nombre no se pudo cargar.
ocupadoPor.id	string	El ID de implementación de la aplicación.
ocupadoPor.nombreDeSistema	string	El nombre del sistema de la aplicación.
ocupadoPor.título	string	El título de la aplicación publicada.
ocupadoPor.títuloDeImplementación	string	El nombre que se le dio a la aplicación cuando se implementó.
ocupadoPor.DescripciónDeImplementación	string	La descripción de la aplicación implementada.
ocpedBy.implementVersion	number	El número de versión implementada.
ocupadoPor.semVersion	string	La versión semántica de la aplicación implementada.
ocupadoPor.fechaDeImplementación	string	La fecha y hora en que se implementó la aplicación, en formato ISO 8601.
ocupadoPor.carpeta.implementación	object	La carpeta en la que se implementa la aplicación.
ocpedBy.implementationfolder.key	string	La clave de la carpeta.
ocpedPor.implementación.Carpeta.id	number	El ID de la carpeta.
ocpedBy.deploymentFolder.displayName	string	El nombre para mostrar de la carpeta.
OcupadoPor.CarpetaDeImplementación.NombreCompletamenteCualificado	string	La ruta completa de la carpeta.
ocupadoPor.isAppPublic	boolean	true si la aplicación es de acceso público.
ocupadoPor.esLaTestVersión	boolean	true si la versión implementada es la última versión publicada.
ocupadoPor.esRecursoActivado	boolean	false si la aplicación implementada está desactivada. Una aplicación desactivada aún conserva su nombre de enrutamiento. No está presente en todas las aplicaciones. Si el campo está ausente, la aplicación está activa.
OcupadoPor.NombreDeEnrutamiento	string	El nombre de enrutamiento utilizado en la URL de la aplicación.

400 Bad Request

La variable de ruta routingName está vacía o solo contiene espacios en blanco.

401 No autorizado

No está autenticado. Asegúrate de utilizar un token de acceso válido con el ámbito Apps o Apps.Read .

403 Forbidden

No tiene permiso para comprobar la exclusividad del nombre de la aplicación en la organización especificada.