Passer au contenu principal

Action de requête HTTP

Send an HTTP request to an external endpoint as part of an automation pipeline.

Introduction

Envoyez une requête HTTP vers n'importe quel point de terminaison lors de l'exécution d'une automatisation. Utilisez cette action pour intégrer les automatisations Level à des systèmes externes — déclenchez des webhooks, publiez des données vers une API, ou appelez n'importe quel point de terminaison HTTP dans le cadre d'un flux de travail.


Action de requête HTTP

Depuis le pipeline d'automatisation en mode édition, cliquez sur + et sélectionnez Requête HTTP depuis la catégorie Autre.

HTTP Request Action

URL

Le point de terminaison vers lequel envoyer la requête. Obligatoire. Cliquez sur (x) pour insérer une variable, une variable système ou une référence à un champ personnalisé.

Méthode

La méthode HTTP utilisée pour la requête.

Méthodes prises en charge : GET, POST, PUT, DELETE, PATCH.

Type de contenu

Le type de contenu du corps de la requête.

Option

Utilisation

application/json

Charges utiles JSON

text/plain

Texte brut

application/x-www-form-urlencoded

Soumissions de formulaires

Corps

Le corps de la requête. Cliquez sur (x) pour insérer des références à des variables afin d'inclure des données dynamiques provenant du pipeline.

En-têtes

Cliquez sur + Ajouter des en-têtes de requête pour ajouter des paires clé-valeur d'en-têtes personnalisés. Cliquez sur (x) sur l'un ou l'autre champ pour insérer une référence à une variable. Cliquez sur × pour supprimer une ligne d'en-tête.

En-têtes courants :

  • Authorization: Bearer {{api_token}}

  • X-API-Key: {{api_key}}


Conditions

La section Conditions vous permet de restreindre l'exécution de cette action en fonction des attributs de l'appareil ou du résultat d'une action précédente.

Consultez Conditions d'action pour la référence complète sur les types de conditions, les opérateurs et les valeurs.


Options supplémentaires

Développez Options supplémentaires pour le nom de l'action, le comportement en cas d'échec, l'assignation d'une variable de sortie, les nouvelles tentatives et le commutateur d'activation.

💡 CONSEIL : Utilisez Assigner la sortie de l'action à une variable dans les Options supplémentaires pour capturer le corps de la réponse HTTP dans une variable d'automatisation. Cela permet aux actions suivantes d'agir sur la réponse — par exemple, vérifier un champ de statut renvoyé par une API.

Consultez Vue d'ensemble des actions pour la référence complète sur les options supplémentaires disponibles pour chaque action.


FAQ

  • Qu'est-ce qui constitue une requête réussie ? Une requête est considérée comme réussie lorsque le point de terminaison renvoie un code de réponse HTTP 2xx. Tout réponse non-2xx (4xx ou 5xx) est considéré comme une erreur et l'action sera marquée comme ayant échoué.

  • Puis-je envoyer du JSON dans le corps ? Oui — définissez Content-Type: application/json dans la section En-têtes et rédigez votre charge utile JSON dans le champ Corps.

  • Puis-je m'authentifier auprès d'un point de terminaison protégé ? Oui — incluez un en-tête Authorization avec votre jeton ou vos identifiants. Utilisez (x) pour référencer une variable d'automatisation stockée ou un champ personnalisé plutôt que de coder la valeur en dur.

  • Qui peut ajouter ou modifier des actions de requête HTTP ? Les techniciens autorisés à modifier les automatisations dans le groupe concerné. Consultez Espace de travail → Autorisations pour la configuration du contrôle d'accès.

Avez-vous trouvé la réponse à votre question ?