http

L'activité HTTP vous permet d'effectuer des requêtes d'API basées sur des données JSON dans votre workflow. Il offre un contrôle total sur la configuration des requêtes, permettant de définir dynamiquement les méthodes, les URL, les en-têtes et le contenu du corps. Après l’exécution, les données de réponse deviennent disponibles pour référence dans les étapes suivantes du workflow, ce qui en fait un composant essentiel pour l’interaction avec les API externes.

Limites connues

• Ne prend pas en charge les connexions configurées via Integration Service. Pour utiliser l'authentification ou les connexions existantes à partir d'un connecteur, utilisez l'activité Connecteur et sélectionnez l'activité Demande HTTP à partir de ce connecteur.
• Prend en charge uniquement les requêtes et les réponses basées sur les données JSON. Assurez-vous que vos demandes incluent des en-têtes, tels que Content-Type: application/json et Accept: application/json.

Utilisation de l'activité HTTP

Voici comment ajouter une activité HTTP à votre workflow :

1. Sur votre canevas de conception de workflow d'API, sélectionnez l'icône plus (+). Le menu Ajouter une activité s'affiche.
2. Sélectionnez HTTP.
3. Dans le panneau Propriétés , configurez les champs suivants :
   • Method : spécifie la méthode HTTP de la requête, par exemple GET, POST, PATCH, DELETE ou PUT.
   • URL de la demande : définit le point de terminaison de l’API pour la demande. Vous pouvez créer dynamiquement des URL à l'aide de l' éditeur d'expressions. Par exemple, il faut ajouter un ID récupéré à partir d'une étape précédente du workflow.
   • En-têtes : définit les en-têtes de demande sous la forme de paires clé-valeur. Les en-têtes utilisent un format d'objet JSON et peuvent être générés dynamiquement avec l'éditeur d'expressions. Par exemple :

     {
       "Content-Type": "application/json",
       "Accept": "application/json",
       "Authorization": "Bearer jfio**********"
     }

   • Corps de la requête : disponible pour toutes les méthodes HTTP à l’exception de GET et HEAD. Prend en charge les charges utiles basées sur JSON, ce qui vous permet de référencer les données des sorties des étapes précédentes à l'aide de l' éditeur d'expressions.
4. Testez le workflow pour exécuter l'activité et générer des champs de sortie pour une utilisation ultérieure.

Exemple d'activité HTTP

Cet exemple suivant va envoyer une requête POST à HTTPBin, qui renvoie les données de la requête pour validation. La requête comprend des variables de chemin dynamique, des en-têtes et un corps de requête structuré.

Ouvrez la fenêtre de configuration de débogage , puis collez et enregistrez la syntaxe JSON suivante :

{
  "id": 12345,
  "name": "John Doe",
  "isActive": true,
  "balance": 2500.75,
  "createdAt": "2025-03-25T12:00:00Z",
  "tags": [
    "premium",
    "verified",
    "active"
  ],
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.006
    }
  },
  "transactions": [
    {
      "transactionId": "txn_001",
      "amount": 150.5,
      "currency": "USD",
      "timestamp": "2025-03-24T10:30:00Z",
    },
    {
      "transactionId": "txn_002",
      "amount": -75.25,
      "currency": "USD",
      "timestamp": "2025-03-23T08:15:00Z"
    }
  ]
}

1. Sur votre canevas de conception de workflow d'API, ajoutez une activité Script pour générer une valeur de jeton de porteur :
   1. Ouvrez l' éditeur d'expressions et renvoyez un JSON avec une propriété nommée porteur_token:

      return {
          "bearer_token": "123321123321"
      }

   2. Enregistrez.
2. Ajoutez une activité HTTP au canevas du concepteur.
3. Configurez l’activité HTTP comme suit :
   • Méthode—PUBLIER
   • URL de la demande—Utilisez l’éditeur d’expressions pour créer la chaîne d’URL avec une variable de chemin d’accès :

     "https://www.httpbin.org/anything/" + ($workflow.input.id | tostring)

   • En-têtes : ajoutez des en-têtes en spécifiant un simple fichier JSON clé-valeur. Vous simulez également le processus d'ajout d'un jeton du porteur comme en-tête d'autorisation :

     {
         "Accept": "application/json",
         "Content-Type": "application/json",
         "Authorization": ("Bearer " + $context.outputs.Javascript_3.bearer_token)
     }

   • Corps de la requête : utilisez l’éditeur d’expressions pour créer dynamiquement le corps de la requête en référençant votre configuration d’exécution JSON. L'objectif est de transmettre un tableau de transactions encapsulées dans un objet en tant que charge utile de la requête :

     {
         "transactions": $workflow.input.transactions
     }

   Notez que le panneau de sortie de l’ expression montre à quoi devrait ressembler le fichier JSON final en fonction des données d’entrée du test d’activité :

   
4. Testez le workflow pour exécuter l'activité.
5. Vérifiez le panneau Sortie pour examiner la réponse HTTP.