Vérifier l’unicité du nom de l’application

Référence d'API pour vérifier si un nom de routage d'application déployé est unique au sein de l'organisation.

Vérifie si un nom de routage donné est unique pour les applications déployées au sein de l’organisation. Si le nom est déjà utilisé, la réponse renvoie également l'application déployée qui le contient.

Point de terminaison de l’API

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

Voir URL de base pour le chemin du point de terminaison racine.

En-têtes de requête.

En-tête	Valeur (Value)
Autorisation	Porteur <your-access-token>
X-UiPath-Interne-IdLocataire	<tenant_id>

Remarque :

Remplacez toutes les valeurs entre les chevrons <...> par leurs valeurs de cas d’utilisation correspondantes.

L’ <access_token> est celle que vous avez reçue lorsque vous avez autorisé l’application externe avec l’étendue Apps ou Apps.Read . Elle est disponible pendant 1 heure, puis vous devez en générer une nouvelle ou demander un jeton d’actualisation.

Variables de chemin d'accès

Variable de chemin d’accès	Type de données	Description
NomRoutage (requis)	string	Le nom de routage dont vous souhaitez vérifier l'unicité.

Réponses

200 OK

Si le nom du routage est disponible, occupiedBy est null:

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

Si le nom de routage est déjà utilisé, occupiedBy renvoie l'application déployée qui le contient:

{
  "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"
  }
}

Champ	Type de données	Description
Est unique	boolean	true si le nom de routage est disponible, false s’il est déjà utilisé.
OccupéPar	object	L'application déployée qui contient le nom du routage. null lorsque isUnique est true. Il peut également s'agir null lorsque isUnique est false, si l'application contenant le nom n'a pas pu être chargée.
occupéPar.id	string	ID de déploiement de l'application.
OccupéPar.NomSystème	string	Le nom système de l'application.
occupéPar.titre	string	Le titre de l’application publiée.
TitreDéploiement OccupéPar	string	Le nom donné à l'application lors de son déploiement.
DescriptionDéploiement.	string	La description de l’application déployée.
occupéPar.versionDéploiement	number	Le numéro de version déployé.
OccupéPar.semVersion	string	La version sémantique de l’application déployée.
occupéPar.dateDéployé	string	La date et l'heure de déploiement de l'application, au format ISO 8601.
dossierDéploiement.	object	Le dossier dans lequel l'application est déployée.
occupéPar.dossierDéploiement.clé	string	La clé de dossier.
occupéPar.dossierDéploiement.id	number	L'ID de dossier.
nomComplet.DéploiementFolder.NomComplet	string	Nom affiché du dossier.
occupéPar.deploymentFolder.FullQualifiedName	string	Le chemin d’accès complet au dossier.
occupéPar.estAppPublique	boolean	true si l'application est accessible au public.
OccupéPar.estDernièreVersion	boolean	true si la version déployée est la dernière version publiée.
OccupéPar.estResourceActivé	boolean	false si l’application déployée est désactivée. Une application désactivée conserve toujours son nom de routage. Non présent sur chaque application. Si le champ est absent, l’application est active.
OccupéPar.nomRoutage	string	Le nom de routage utilisé dans l’URL de l’application.

400 Requête incorrecte

La variable de chemin routingName est vide ou contient uniquement des espaces.

401 Non autorisé

Votre authentification n’est pas requise. Assurez-vous d’utiliser un jeton d’accès valide avec l’étendue Apps ou Apps.Read .

403 Forbidden

Vous n’avez pas l’autorisation de vérifier l’unicité du nom de l’application dans l’organisation spécifiée.