Aller au contenu principal

Nœud Réponse HTTP

Le nœud Réponse HTTP permet de retourner une réponse HTTP au client qui a déclenché le flux (déclencheur de type Route d'une API, y compris les webhooks entrants configurés sur ce type) : retourner des données au client, indiquer le succès ou l'échec d'une opération, retourner des codes de statut HTTP appropriés et envoyer des headers personnalisés.

Paramètres​

ParamètreTypeObligatoireDéfautDescription
AppApp❌—Application associée au nœud.
Code de statut200 / 201 / 400 / 401 / 404 / 500 / personnalisé✅—Code HTTP retourné au client.
HeadersClé-valeur❌—En-têtes HTTP de la réponse. Supportent les variables Handlebars.
BodyJSON❌—Corps de la réponse renvoyée au client. Peut être vide pour certains codes de statut.

Code de statut​

Sélectionnez le code de statut HTTP à retourner :

  • 200 OK : Succès
  • 201 Created : Ressource créée
  • 400 Bad Request : Requête invalide
  • 401 Unauthorized : Non autorisé
  • 404 Not Found : Non trouvé
  • 500 Internal Server Error : Erreur serveur
  • Ou un code personnalisé

Headers​

Ajoutez des headers personnalisés :

  • Format clé-valeur
  • Supporte les variables Handlebars
  • Headers courants : Content-Type, Location, X-Custom-Header

Exemple :

Content-Type: application/json
X-Request-ID: {{requestId}}

Body​

Corps de la réponse :

  • Format JSON (recommandé)
  • Supporte les variables Handlebars
  • Peut être vide pour certains codes de statut

Exemple :

{
  "success": true,
  "data": {
    "orderId": "{{processedOrder.id}}",
    "status": "processed"
  },
  "message": "Order processed successfully"
}

Comportement​

Un seul nœud Réponse HTTP :

Un flux déclenché par un déclencheur Route d'une API (API ou webhook entrant) ne doit contenir qu'un seul nœud Réponse HTTP :

  • Le premier nœud Réponse HTTP rencontré termine le flux
  • Les nœuds suivants ne sont pas exécutés
  • La réponse est envoyée immédiatement

Flux sans réponse :

Si aucun nœud Réponse HTTP n'est présent :

  • Le flux se termine sans réponse
  • Le client reçoit un timeout ou une erreur
  • Utilisez toujours un nœud Réponse HTTP pour les déclencheurs Route d'une API (API ou webhook)

Entrée​

Le nœud reçoit les données du contexte du flux (déclencheur Route d'une API ou nœuds précédents) et les injecte dans les headers et le corps de la réponse via les variables Handlebars :

{
  "requestId": "req_7f3a",
  "processedOrder": {
    "id": "CMD-4821",
    "status": "processed"
  }
}

La réponse envoyée au client utilise ces variables, par exemple X-Request-ID: {{requestId}} et "orderId": "{{processedOrder.id}}".

Sortie​

Le nœud Réponse HTTP ne génère aucune variable de contexte : il termine le flux et renvoie la réponse au client. Rien ne peut être consommé dans les nœuds suivants — placez-le toujours en fin de branche.

Erreurs​

Si aucun nœud Réponse HTTP n'est présent dans un flux déclenché par une Route d'une API, le flux se termine sans réponse et le client reçoit un timeout ou une erreur. Utilisez toujours un nœud Réponse HTTP pour ce type de déclencheur.

Limites​

Un flux déclenché par un déclencheur Route d'une API (API ou webhook entrant) ne doit contenir qu'un seul nœud Réponse HTTP.

Exemple​

Répondre à une requête REST :

  1. Un déclencheur Route d'une API reçoit la requête du client.
  2. Des nœuds traitent la donnée (ex. Nœud Requête HTTP(S) ou Nœud Condition).
  3. Le nœud Réponse HTTP renvoie le code de statut, les headers et le corps au client — le premier nœud Réponse HTTP rencontré termine le flux.

Créez des endpoints REST complets :

  • GET : Récupérer des données
  • POST : Créer des ressources
  • PUT : Mettre à jour
  • DELETE : Supprimer

Répondre à un webhook reçu :

  • Confirmer la réception
  • Retourner un statut de traitement
  • Indiquer les erreurs

Voir aussi​