Aller au contenu principal

Nœud HTTP Response

Le nœud HTTP Response permet de retourner une réponse HTTP au client qui a déclenché le workflow (pour les triggers API Endpoint ou Webhook).

Vue d'ensemble​

Ce nœud est utilisé pour :

  • 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
  • Envoyer des headers personnalisés

Configuration​

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 HTTP Response​

Un workflow déclenché par un trigger API Endpoint ou Webhook ne doit contenir qu'un seul nœud HTTP Response :

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

Workflows sans réponse​

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

  • Le workflow se termine sans réponse
  • Le client reçoit un timeout ou une erreur
  • Utilisez toujours un nœud HTTP Response pour les triggers API Endpoint/Webhook

Exemples​

Exemple 1 : Réponse de succès​

{
  "status": 200,
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "success": true,
    "data": "{{processedData}}"
  }
}

Exemple 2 : Réponse d'erreur​

{
  "status": 400,
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "success": false,
    "error": "Invalid input data",
    "details": "{{validationErrors}}"
  }
}

Exemple 3 : Création de ressource​

{
  "status": 201,
  "headers": {
    "Content-Type": "application/json",
    "Location": "/api/resources/{{newResource.id}}"
  },
  "body": {
    "id": "{{newResource.id}}",
    "status": "created"
  }
}

Bonnes pratiques​

  • Toujours répondre : Utilisez toujours un nœud HTTP Response pour les triggers API Endpoint/Webhook
  • Codes appropriés : Utilisez les codes de statut HTTP appropriés
  • Format cohérent : Utilisez un format de réponse cohérent dans toute votre API
  • Gestion d'erreurs : Retournez des codes d'erreur appropriés en cas d'échec
  • Headers : Utilisez les headers appropriés (Content-Type, etc.)
  • Documentation : Documentez le format de réponse attendu

Cas d'usage​

API REST​

Créez des endpoints REST complets :

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

Webhooks​

Répondez aux webhooks reçus :

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

Prochaines étapes​