Control Room API
- Dernière mise à jour2024/11/22
Control Room API
La Automation Anywhere Control Room fournit des API qui vous permettent de personnaliser la manière dont vous (et vos automatisations) interagissez avec Automation Anywhere.
- Depuis Automation 360 v.34, les points de terminaison de l\'API WLM suivants sont obsolètes et devraient être abandonnés (fin de vie) à la publication de la v.38 :
-
POSTER
/v3/wlm/workitemmodel
-
OBTENIR
/v3/wlm/workitemmodels/{id}
-
OBTENIR
/v3/wlm/queues/{id}
-
POST
/v3/wlm/queues/{id}/consommateurs
-
POST
/v3/wlm/queues/{id}/participants
-
PUT
/v3/wlm/queues/{id}/members/{userId}
-
POST
/v3/wlm/queues/{id}/file
-
PUT
/v3/wlm/queues/{id}/workitems/{workItemId}
-
POST
/v4/wlm/workitemmodel
-
OBTENIR
/v4/wlm/workitemmodels/{id}
-
OBTENIR
/v4/wlm/queues/{id}
-
POST
/v4/wlm/queues/{id}/consommateurs
-
POST
/v4/wlm/queues/{id}/participants
-
PUT
/v4/wlm/queues/{id}/members/{userId}
-
POST
/v4/wlm/queues/{id}/file
-
PUT
/v4/wlm/queues/{id}/workitems/{workItemId}
-
POSTER
- À partir de la version Automation 360 v.34, les points de terminaison de l\'API du Bot Scheduler :
/v1/schedule/automations
sont obsolètes et sont remplacés par/v2/schedule/automations
. La version v1 devrait être abandonnée (fin de vie) à la publication de la v.38.
Vous pouvez consulter et parcourir tous les modules d\'API de la Control Room et les points de terminaison associés dans les sections de référence de l\'API suivantes.
Les différentes versions d\'API ci-dessous représentent différentes itérations d\'API au fil du temps. À mesure qu\'une API évolue, de nouvelles fonctionnalités ou améliorations sont introduites. Pour gérer ces changements et conserver la compatibilité avec les applications existantes, les développeurs utilisent la gestion des versions.
Points de terminaison v1
Modules | Description |
---|---|
API d\'authentification | Utilisez les API d\'authentification v1 pour vérifier l\'authenticité et l\'intégrité des jetons Web JSON (JWT), ainsi que pour mettre fin aux sessions utilisateur actives. |
API d\'audit | Utilisez les API d\'audit pour récupérer les données du journal d\'audit de votre Control Room. |
API de périphérique | Utilisez les API de l\'appareil pour identifier tous les utilisateurs disponibles avec des licences de robot non assisté Bot Runner, ou filtrez les utilisateurs par nom. |
API d\'automatisation | Obsolète Utilisez les API de planificateur de robots v1 (API d\'automatisation) pour créer, mettre à jour, supprimer et retourner des détails sur les automatisations planifiées. |
API de déclenchement | Utilisez les API de déclenchement pour mapper les déclencheurs aux utilisateurs ou rôles pour un utilisateur de Bot Runner assisté. Vous pouvez également créer et supprimer des déclencheurs d\'événements. |
API d\'exécution de tâches API | Utilisez les API d\'exécution de tâche API pour générer une URL d\'exécution de tâche API, ainsi qu\'un jeton pour démarrer une exécution de tâche API via un point de terminaison de l\'API. |
API de gestion des politiques | Utilisez les API de gestion des Stratégies pour gérer l\'analyse de code, les stratégies et les règles au sein de Control Room. |
API du Studio d\'Agent IA | Utilisez les API Studio d\'Agent IA pour définir et vous connecter à des modèles Connexions des modèles personnalisés. Vous pouvez également récupérer et supprimer le Connexions des modèles personnalisé. |
Points de terminaison v2
Modules | Description |
---|---|
API d\'authentification | Utilisez les API d\'authentification v2 pour générer et actualiser les jetons JWT nécessaires à l\'autorisation dans toutes les API Enterprise Control Room. |
API de gestion des utilisateurs | Utilisez les API de gestion des utilisateurs pour afficher et supprimer des rôles et des utilisateurs dans votre Control Room. |
API Credential Vault | Utilisez les API de Credential Vault pour créer, récupérer, mettre à jour et supprimer des identifiants, des valeurs d\'attributs d\'identifiant, des coffres et des clés. |
API d\'orchestration d\'exécution de Bot | Utilisez l\'API v2 Bot Execution Orchestrator pour surveiller les appareils. |
API de gestion des référentiels | Utilisez les API de gestion de référentiel pour effectuer des tâches spécifiques sur des objets (robots, dossiers et fichiers) auxquels vous êtes autorisé à accéder dans la Control Room. |
API BotInsight | Utilisez les API de Bot Insight pour accéder aux informations commerciales en temps réel et aux données de performance de la main-d\'œuvre numérique afin d\'utiliser les données de productivité au niveau du contenu provenant des automatisations déployées. |
API BLM | Utilisez les API de gestion du cycle de vie des robots (BLM) pour exporter et importer des robots avec des fichiers dépendants et des packages de commande pour une gestion complète du cycle de vie de l\'automatisation. |
API de pool de périphériques | Utilisez les API de pool de périphériques pour créer, répertorier, mettre à jour et supprimer des pools de périphériques. |
API de licence | Utilisez les API de licence pour récupérer les Détails de la licence de la Control Room et synchroniser manuellement la Control Room avec le serveur de licences après la réaffectation ou le renouvellement de la licence. |
Process Composer API | Utilisez les API Processor Composer pour créer une nouvelle demande à partir des processus, récupérer le formulaire initial et demander par ID de référence. |
API d\'automatisation | Utilisez les API du Planificateur de Bot v2 (API d\'automatisation) pour créer, mettre à jour, supprimer et retourner des détails sur les automatisations programmées. |
API de gestion des politiques | Utilisez les API de gestion des Stratégies v2 pour gérer l\'analyse de code, les stratégies et les règles au sein de Control Room. |
Points de terminaison v3
Modules | Description |
---|---|
API de déploiement de Bot | Utilisez l\'API v3 Deploy Bot pour déployer des robots depuis l\'espace de travail public vers des appareils Bot Runner. |
API de gestion de la charge de travail | Utilisez les API de gestion de la charge de travail (WLM) v3 pour gérer et créer par programme des modèles d\'éléments de travail, des files d\'attente, des éléments de travail et des automatisations dans votre Control Room. |
API de migration (migration de Bot) | Utilisez les API de migration v3 pour migrer les TaskBots et les MetaBots créés dans les versions client Enterprise 11 et Enterprise 10 vers Automation 360. |
API d\'orchestration d\'exécution de Bot | Utilisez les API de l\'Orchestrateur d\'Exécution v3 Bot pour surveiller l\'avancement de l\'activité d\'automatisation. |
Points de terminaison v4
Modules | Description |
---|---|
API de déploiement de Bot (V4) | Utilisez l\'API v4 Deploy Bot pour déployer des robots depuis l\'espace de travail public vers des appareils Bot Runner. |
API de gestion de la charge de travail | Utilisez les API de gestion de la charge de travail (WLM) v4 pour gérer et créer par programme des modèles d\'éléments de travail, des files d\'attente, des éléments de travail et des automatisations dans votre Control Room. |
API de migration (migration de Bot) | Utilisez les API de migration v4 pour migrer les TaskBots et les MetaBots créés dans les versions client Enterprise 11 et Enterprise 10 vers Automation 360. |
Premiers pas avec les API de la Control Room
Toutes les demandes doivent inclure un en-tête X-Authorization avec le jeton d\'authentification JSON ou l\'en-tête Authorization avec un Bearer token pour les demandes adressées à la Control Room. Les sections suivantes fournissent des détails sur les points de terminaison, les méthodes, les ressources, les protocoles d\'authentification, les paramètres et les en-têtes des API de la Control Room disponibles, ainsi que des exemples de demandes et de réponses courantes.
- Certaines API vous obligent à filtrer, paginer et trier les résultats pour obtenir le résultat souhaité. Pour plus d\'informations sur le filtrage, la pagination et le tri, voir Filtrage, pagination et tri.
- Les codes de réponse de l\'API dans les réponses sont décrits dans le Codes de réponse de l'API.
- Le Comparaison entre les API Automation 360 et Enterprise 11 compare les API Enterprise 11 et Automation 360.
Politique de dépréciation de l\'API
La dépréciation de l\'API indique qu\'une API n\'est plus recommandée pour une utilisation mais est fonctionnelle. Les développeurs sont encouragés à migrer vers des versions plus récentes et prises en charge de l\'API. L\'API sera disponible jusqu\'à la date de fin de vie (EoL) et la version de sortie pour permettre une transition en douceur.
API EoL (Fin de Vie) indique la date et la version de publication à laquelle l\'API cessera de fonctionner et ne sera plus disponible à l\'utilisation. Les développeurs devraient avoir terminé leur migration vers les versions plus récentes et prises en charge de l\'API avant cette date.
Les scénarios suivants peuvent nécessiter la dépréciation des API:
- Vulnérabilités de sécurité: Les anciennes versions de l\'API contiennent des vulnérabilités de sécurité connues qui ont été corrigées dans les versions plus récentes.
- Dette technique: Les anciennes versions d\'API peuvent être construites sur des technologies, des approches ou des frameworks obsolètes qui ne sont plus pris en charge, rendant la maintenance ou les améliorations difficiles.
- Performance : Les anciennes versions de l\'API ne sont pas optimisées pour les cas d\'utilisation modernes ou les augmentations d\'échelle, ce qui entraîne de mauvaises performances et des temps de réponse plus lents.
- Expérience utilisateur : Les versions d\'API obsolètes contiennent des points de terminaison confus ou redondants qui peuvent rendre la navigation difficile pour les utilisateurs.
Les API seront prises en charge pendant une période minimale de 2 ans. Après 2 ans, une dépréciation de l\'API peut être annoncée, l\'API étant disponible pendant au moins un an de plus (quatre versions) pour vous donner suffisamment de temps pour passer à la version plus récente.