DocumentationWorkflowsApps et services
HTTP node
Appelle une URL externe, p. ex. une API, un autre webhook ou un serveur MCP. L'auth, le body, les en-têtes et les paramètres de requête peuvent être remplis à partir de templates. Le body de la réponse est automatiquement parsé en JSON. Découvrez sa configuration, les entrées et sorties, le test et la résolution des erreurs.
10 min de lectureMis à jour le
Fonction du node
Appelle une URL externe, p. ex. une API, un autre webhook ou un serveur MCP. L'auth, le body, les en-têtes et les paramètres de requête peuvent être remplis à partir de templates. Le body de la réponse est automatiquement parsé en JSON.
Utilisez HTTP comme étape clairement définie dans un workflow anymize.
- Traite 1 entrée.
- Fournit 1 sortie aux étapes suivantes.
- S'exécute comme une étape normale du workflow.
Configurer le node
- 01Ouvrez un workflow et ajoutez HTTP depuis le catalogue.
- 02Renseignez les champs requis et associez les valeurs des étapes précédentes.
- 03Testez le node avec un petit jeu de données et vérifiez sa sortie.
- 04Reliez la sortie réussie et activez le workflow après un test complet.
Actions et modes
HTTP remplit une fonction précise. Ses paramètres apparaissent lorsque vous sélectionnez le node.
Paramètres
| Champ | Signification | Zone |
|---|---|---|
| Méthode | Choix: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS | Standard |
| URL | Configurez cette valeur dans le panneau du node. | Standard |
| Authentification | Comment l'API externe s'authentifie. Le token / la clé / le mot de passe vont dans le champ correspondant ci-dessous. | Standard |
| Identifiants depuis un secret de workflow | Choisis le secret de workflow contenant le token, la clé API ou le mot de passe Basic Auth. La valeur en clair n’entre jamais dans le JSON du workflow. | Protégé |
| Nom du champ de clé | Comment s'appelle le champ dans lequel l'API attend ta clé. C'est généralement dans la doc de l'API, souvent X-API-Key. | Standard |
| Nom du paramètre de clé dans l'URL | Comment s'appelle le paramètre dans l'URL qui porte ta clé, p. ex. ?api_key=… . C'est dans la doc de l'API. | Standard |
| Nom d'utilisateur | Configurez cette valeur dans le panneau du node. | Standard |
| Paramètres de requête | Ajoutés à l'URL sous forme ?key=value. Les chaînes de requête déjà présentes dans l'URL sont conservées. | Standard |
| Headers | Paires clé/valeur comme champs. Authorization est défini automatiquement via le champ Auth ci-dessus, ici, uniquement les en-têtes personnalisés. | Standard |
| Format du body | Comment le body est transmis. « Form » pour les anciennes API qui attendent les champs comme des données de formulaire ; « Brut » pour du XML ou du texte pur. En cas de doute : Automatique. | Standard |
| Body | Éditeur no-code : ajoute champ + valeur, le type (texte/nombre/booléen/JSON) est détecté automatiquement. En haut à droite, tu peux basculer en JSON brut. | Standard |
| Lire la réponse comme | JSON arrête le workflow si la réponse ne contient pas de données structurées valides. | Standard |
| Transmettre | Lorsqu’une liste est reçue, l’étape suivante peut traiter chaque entrée séparément. | Standard |
| Nom du texte ou du fichier | L’étape suivante retrouve le texte ou le fichier sous ce nom. Les données JSON gardent leurs propres noms de champs. | Standard |
| Contrat d’import | Configurez cette valeur dans le panneau du node. | Standard |
| Format des données importées | Configurez cette valeur dans le panneau du node. | Standard |
| Suivre les redirections | Appelle la nouvelle adresse en cas de redirection. Sinon, l’étape suivante reçoit la première réponse. | Standard |
| En cas d'erreur HTTP | « Continuer » laisse le workflow se poursuivre même en cas de 4xx/5xx ou d'erreurs réseau, tu vérifies $json.ok et tu réagis (retry, fallback, log). | Standard |
| Abandonner après (millisecondes) | Abandonne la requête si l'autre partie met trop de temps. En millisecondes (1000 = 1 seconde). Maximum 30000 (30 secondes). | Standard |
| Taille maximale de réponse (octets) | Les réponses plus grandes sont abandonnées pour ne pas surcharger le workflow. Indication en octets (5000000 = 5 Mo). Par défaut 5 Mo, maximum 10 Mo. | Standard |
| Exécuter une fois par élément | Désactivé (par défaut) : le node s'exécute une fois pour tout l'input. Activé : s'il reçoit plusieurs éléments (par ex. de « Séparer la liste »), il s'exécute une fois PAR élément, et {{ $json }} correspond alors à cet élément. C'est ainsi que tu traites une liste de fichiers entrée par entrée. | Standard |
| Pause entre les éléments (millisecondes) | Attente avant chaque exécution sauf la première. 1000 = 1 seconde par élément. Utile si le service distant te limite. Maximum 300000 (5 minutes). | Standard |
Entrées et sorties
| Entrée | Signification | Type |
|---|---|---|
| url | URL cible. Remplace le champ de config. | text |
| body | Body de la requête. | json |
| Sortie | Signification | Type |
|---|---|---|
| body | Configurez cette valeur dans le panneau du node. | json |
| status | Code de statut HTTP. | number |
| ok | true pour 2xx, false sinon. | boolean |
| headers | En-têtes de réponse (clés en minuscules). | json |
Exemple et test
GET d'API avec token Bearer: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez uniquement les champs présents.
Exemple de test
{
"query": "anymize",
"limit": 10
}Accès et sécurité
Avant l'activation, vérifiez les données reçues par cette étape et le contenu de sa sortie.
Stockez les clés et identifiants dans le gestionnaire protégé. Ne les insérez jamais dans les champs, données de test ou descriptions.
Résoudre les erreurs
- Aucune sortie: vérifiez la dernière exécution et les champs fournis par le node précédent.
- Variable vide: ouvrez la sortie précédente et utilisez un nom de champ réellement présent.