Passer au contenu principal

Action de demande HTTP

Envoyer une requête HTTP à un point de terminaison externe dans le cadre d'un pipeline d'automatisation.

Mis à jour il y a moins d’une heure

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


Action de demande HTTP

À partir du pipeline d'automatisation en mode édition, cliquez sur + et sélectionnez Demande HTTP dans la catégorie Autre.

Action de demande HTTP

URL

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

Méthode

La méthode HTTP pour la requête.

Méthodes supportées : GET, POST, PUT, DELETE, PATCH.

Type de contenu

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

Option

Utilisation

application/json

Charges 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 de variables pour inclure des données dynamiques du pipeline.

En-têtes

Cliquez sur + Ajouter des en-têtes de requête pour ajouter des paires de clés-valeurs d'en-tête personnalisé. Cliquez sur (x) sur l'un ou l'autre champ pour insérer une référence de 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 le moment où cette action s'exécute en fonction des attributs du dispositif ou du résultat d'une action précédente.

Voir 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 d'échec, l'attribution des variables de sortie, les 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, en vérifiant un champ de statut renvoyé par une API.

Voir Aperçu des actions pour la référence complète sur les options supplémentaires disponibles sur chaque action.


FAQ

  • Qu'est-ce qui compte comme 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. Toute réponse non-2xx (4xx ou 5xx) est traitée comme une erreur et l'action sera marquée comme échouée.

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

  • Puis-je authentifier à 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 les actions de demande HTTP ? Les techniciens ayant la permission d'éditer les automatisations dans le groupe concerné. Voir Espace de travail → Permissions pour la configuration du contrôle d'accès.

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