Lorsque vous ajoutez une action manuellement, vous devez configurer les détails de l\'action en ajoutant le chemin d\'accès et les paramètres de requête, les en-têtes, les requêtes et la réponse.

Lorsque vous importez une définition d\'API, vous devez vérifier et modifier les détails de l\'action pour vous assurer que celle-ci possède les valeurs appropriées pour vos besoins. Ces détails seront affichés dans Bot editor ou dans l\'éditeur API Task lors de l\'utilisation du package. Lorsque vous ajoutez une action, la page de configuration Actions s\'affiche. L\'onglet Configuration affiche divers paramètres de configuration et l\'onglet Essai vous permet d\'essayer l\'action. Les paramètres suivants sont disponibles dans l\'onglet Configuration.

Paramètres dans l\'onglet Configuration

Méthode HTTP
Spécifiez le type de requête REST que vous devez envoyer au serveur API REST. Les méthodes HTTP suivantes sont prises en charge :
  • GET
  • PUT
  • POST
  • DELETE
  • Correctif
Remarque : Lorsque vous importez une définition d\'API, l\'éditeur de connecteurs ignore les actions avec des méthodes non prises en charge et inclut le reste dans le connecteur personnalisé.
Point de terminaison
Saisissez l\'URL du point de terminaison que vous utilisez pour cette action. L\'utilisateur du package ne peut pas voir cette URL. Utilisez des accolades {} pour entourer le chemin et les paramètres de requête dans l\'URL. Par exemple, /{version}/produit/{productid}?status={productStatus}.
URL complète
Ce champ en lecture seule affiche le champ généré automatiquement qui combine l\'URL de base que vous saisissez lors de la création du package et l\'URL de point de terminaison du champ Point de terminaison. Cette URL ne sera pas visible pour l\'utilisateur du package.
Paramètres de requête
Les paramètres de requête vous permettent d\'identifier, de trier et de filtrer les réponses du serveur API. Utilisez l\'option Ajouter un paramètre pour ajouter des paramètres de requête. Vous pouvez ajouter des paramètres de chemin et de requête. Assurez-vous que les paramètres correspondent au chemin d\'URL Point de terminaison. Pour plus d\'informations sur l\'ajout de paramètres de requête, voir Paramètres de la demande.
En-têtes de requête
Les en-têtes de requête vous permettent d\'ajouter des informations supplémentaires à la requête. Vous pouvez ajouter des en-têtes de requête tels que Accept, Content-Length, Content-Type et Cookie. Pour plus d\'informations sur l\'ajout d\'en-têtes de requête, voir En-têtes de demande.
Corps de la requête
La section Corps de la requête vous permet d\'importer un exemple de charge utile afin de définir la structure du corps de la requête. La charge utile sont les données réelles requises pour créer, mettre à jour ou supprimer une ressource sur le serveur API. Lorsque l\'action s\'exécute, la requête inclut cette charge utile. Pour plus d\'informations sur l\'ajout d\'un corps de requête, voir Corps de la demande.
Les options suivantes sont disponibles :
  • JSON : Sélectionnez cette option pour importer un exemple JSON afin de mapper les attributs du corps de requête. Les nœuds terminal seront capturés et affichés ici sous la forme d\'une liste d\'attributs. JSON offre de la flexibilité grâce à sa structure de paires clé-valeur. Pour plus d\'informations sur l\'option JSON dans le corps de requête, voir JSON.
  • Données de formulaire : Sélectionnez cette option pour ajouter des paramètres de données de formulaire en tant qu\'attributs du corps de requête. L\'option Données de formulaire est utile pour télécharger des fichiers vers le serveur API REST en spécifiant le type de contenu. Pour en savoir plus sur l\'option Données de formulaire, voir Données de formulaire.
  • Données encodées dans l\'URL de formulaire : Sélectionnez cette option pour ajouter des paramètres de corps de requête dans le formulaire HTML sous forme de paires clé-valeur encodées dans l\'URL, similaires aux paramètres de requête de type query. Pour plus d\'informations sur les données encodées Données encodées dans l\'URL de formulaire, voir Données encodées dans l\'URL de formulaire
Réponse
L\'option Réponse vous permet d\'importer un échantillon de charge utile à partir de la réponse et de choisir les attributs que vous souhaitez afficher dans le Bot editor et l\'éditeur API Task. Pour plus d\'informations sur l\'ajout d\'un paramètre de réponse, voir Réponse