Créer une API de tâche

Créez un API de tâche avec les packages disponibles dans la Control Room. Vous pouvez créer un API de tâche avec des actions provenant de packages pris en charge par Automation 360 Cloud.

Prérequis

Assurez-vous de disposer d'une licence Bot Creator avec tous les rôles nécessaires décrits dans la rubrique API de tâche.

Dans cette rubrique, nous vous expliquons comment créer une API de tâche à l'aide d'une API qui prend en entrée un code postal aux États-Unis et renvoie en sortie les noms Lieu et État. Vous pouvez créer un API de tâche avec les actions propres à votre cas d'utilisation.

Procédure

Connectez-vous à votre instance de la Automation Anywhere Control Room en tant que Bot Creator.
Créez une API de tâche :
Créez une variable ZipCode comme entrée qui sera utilisée dans l'URL du code postal.
Utilisez l'action Méthode Get pour récupérer le Lieu et l'État d'un code postal.

Remarque : Des packages prédéfinis sont disponibles pour la plupart des applications d'entreprise courantes. Pour une liste des packages pris en charge, consultez FAQ sur les tâches API.
1. Double-cliquez sur l'action Services Web REST > Méthode Get ou faites-la glisser.
2. Saisissez l'URI suivant. $ZipCode$ dans l'URI correspond à la variable d'entrée créée à l'étape 3.
```
https://api.zippopotam.us/us/$ZipCode$
```
3. Dans la liste déroulante Mode d'authentification, sélectionnez Aucune authentification, car ce point de terminaison ne nécessite pas d'authentification.
  
  Remarque : En général, les points de terminaison nécessitent une authentification pour garantir que seules les applications autorisées peuvent accéder aux données. Sélectionnez un mécanisme d'authentification approprié pour autoriser le point de terminaison auquel vous souhaitez accéder.
4. Créez la variable jsonResponse dans le champ Attribuer la sortie à une variable. Pour en savoir plus sur la création d'une variable, consultez la rubrique Création d'une variable.
  Remarque :
  - La réponse JSON complète de l'API est attribuée à cette variable du dictionnaire : jsonResponse.
  - Les types de variables suivants ne sont pas pris en charge pour les Tâches API : Fichier, Fenêtre et Formulaire.
Dans le volet Actions, faites glisser l'action Dictionnaire > Obtenir dans le canevas sous l'action Services Web REST.
1. Dans le champ Variable du dictionnaire, sélectionnez jsonResponse.
2. Dans le champ Clé, saisissez Body.
3. Dans la liste déroulante Attribuer le résultat à une variable, sélectionnez SampleString. À partir de l'ensemble de jsonResponse, stockez uniquement la valeur Body dans une variable (SampleString).
  .
  Vous disposez maintenant de l'ensemble du Body. La tâche suivante consiste à extraire les champs obligatoires du corps. Voici un exemple de JSON Body :
```
{
    "post code": "90210",
    "country": "United States",
    "country abbreviation": "US",
    "places": [
        {
            "place name": "Beverly Hills",
            "longitude": "-118.4065",
            "state": "California",
            "state abbreviation": "CA",
            "latitude": "34.0901"
        }
    ]
}
```
Extrayez le place name du JSON.
1. Dans le volet Actions, faites glisser l'action Chaîne > Extraire un texte dans la toile, sous l'action Dictionnaire > Obtenir.
2. Indiquez le début ou la fin de l'extraction de la chaîne.
3. Créez une variable Lieu et attribuez la sortie à cette variable.
Extrayez le state du JSON.
1. Dans le volet Actions, faites glisser l'action Chaîne > Extraire un texte dans la toile sous l'action Chaîne > Extraire un texte précédente.
2. Indiquez le début ou la fin de l'extraction de la chaîne.
3. Créez une variable État et attribuez la sortie à cette variable.
Cliquez sur Enregistrer.
Pour tester le API de tâche, cliquez sur le Débogueur. Pendant le débogage, le périphérique local est utilisé pour exécuter le API de tâche. Le API de tâche créé dans cet exemple récupère les valeurs Lieu et État pour tout code postal saisi.