Requête HTTP
Appelle une API externe pour chaque élément reçu (adresses publiques uniquement).
Fonctionnement
Une requête par élément reçu. Destinations vérifiées à chaque connexion (après résolution DNS et après chaque redirection) : réseaux privés, boucle locale et métadonnées refusés, sauf politique explicite du déploiement autohébergé. Réponse limitée à 5 Mo.
Paramètres
| Paramètre | Type | Détail |
|---|---|---|
| Méthodeobligatoire | choix | Valeurs : GET, POST, PUT, PATCH, DELETE, HEAD. |
| URLobligatoire | adresse | — |
| Authentification | connexion | Facultatif. |
| Paramètres de requête | clé-valeur | — |
| En-têtes | clé-valeur | — |
| Corpsselon les autres paramètres | choix | Valeurs : Aucun, JSON, Formulaire (urlencoded), Multipart (formulaire avec fichier), Texte brut. |
| Contenu du corpsselon les autres paramètres | texte long | JSON : le texte obtenu après résolution des expressions doit être du JSON valide. |
| Type de contenuselon les autres paramètres | texte | — |
| Champs du formulaireselon les autres paramètres | clé-valeur | — |
| Fichier joint (propriété binaire de l'élément)selon les autres paramètres | texte | Nom du fichier transporté par l'élément (ex. reçu d'une autre requête HTTP en mode fichier). |
| Format de réponse | choix | Valeurs : Automatique (JSON si annoncé), JSON, Texte, Fichier (binaire). |
| Séparer la réponse en éléments | texte | Chemin d'une liste dans la réponse : un élément par entrée. Vide : un élément par réponse. |
| Paginationselon les autres paramètres | choix | Valeurs : Aucune, Numéro de page, URL suivante dans la réponse, Curseur dans la réponse. |
| Paramètre de pageselon les autres paramètres | texte | — |
| Première pageselon les autres paramètres | nombre | — |
| Chemin de l'URL suivanteselon les autres paramètres | texte | — |
| Chemin du curseurselon les autres paramètres | texte | — |
| Paramètre du curseurselon les autres paramètres | texte | — |
| Pages au maximumselon les autres paramètres | nombre | 50 au plus. La pagination s'arrête aussi sur une page vide ou sans suite. |
| Délai d'expiration (secondes) | nombre | Maximum 60 s. |
| Échouer si la réponse est une erreur (4xx/5xx) | oui / non | Désactivé : la réponse d'erreur devient un élément ({ statusCode, body }) et le workflow continue. |
| Envoyer un en-tête Idempotency-Key | oui / non | Permet aux API compatibles d'ignorer les doublons en cas de reprise. Sans cette clé, une écriture (POST, PATCH) n'est jamais relancée automatiquement. |
| Nouvelles tentatives en cas d'erreur temporaire | choix | Erreurs réseau, délais dépassés, réponses 429 et 5xx uniquement. Valeurs : Aucune, 1 tentative supplémentaire, 2 tentatives supplémentaires, 3 tentatives supplémentaires. |
Données reçues et renvoyées
- EntréeListe d'éléments ; chaque élément alimente les expressions de la requête ({{ $json.… }}).
- SortieUn élément par réponse { statusCode, headers, body, url } (ou un élément par entrée de la liste « Séparer la réponse »). En mode fichier, la réponse est jointe à l'élément (binary.data).
Erreurs
Erreur 4xx/5xx (si « Échouer » est activé), délai dépassé, adresse refusée, réponse JSON illisible. Nouvelles tentatives : GET, HEAD, PUT, DELETE, ou écriture avec Idempotency-Key ; jamais sur 401/403.
À savoir. Les effets externes peuvent se répéter si une exécution reprend après un arrêt brutal pendant la requête : la clé Idempotency-Key (stable par exécution, bloc, passage et élément) permet aux API compatibles d'ignorer le doublon.
Exemple
Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.
{
"method": "GET",
"url": "https://api.exemple.fr/v1/contacts",
"query": [
{
"id": "q1",
"key": "limit",
"value": "100"
}
],
"pagination": "pageNumber",
"pageParam": "page",
"pageStart": "1",
"maxPages": "5",
"splitPath": "body.data"
}