http

L’activité Requête HTTP vous permet d’effectuer des requêtes API basées sur des données JSON dans votre workflow. Vous pouvez utiliser le connecteur HTTP générique ou l'un des connecteurs Integration Service pris en charge pour l'authentification, mais vous avez également la possibilité d'utiliser l'activité sans connexion et de fournir des détails d'authentification directement dans la requête.

L'activité offre un contrôle total sur la configuration de la requête, 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.

Remarque : vous pouvez utiliser Autopilot pour vous ajouter la requête HTTP en saisissant l’URL cURL souhaitée dans le chat.

Utilisation de l'activité HTTP

Pour ajouter une activité de requête 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 :
   • Authentification : le type d’authentification à utiliser, soit l’authentification manuelle , soit l’authentification basée sur le connecteur.
   • Connecteur : si vous avez sélectionné Authentification basée sur le connecteur, sélectionnez le connecteur à utiliser.
   • Connexion : la connexion établie dans Integration Service. Sélectionnez une connexion existante, cliquez sur + Connexion pour ajouter une nouvelle connexion, ou cliquez sur Ouvrir les connexions pour gérer les connexions.
   • Méthode : la méthode HTTP de la requête, GET, POST, PATCH, DELETE, PUT, OPTIONS ou HEAD.
   • URL de la demande : 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. Si une URL de base est définie, saisissez un chemin relatif. Pour le remplacer, utilisez une URL absolue avec le même domaine de base.
   • En-têtes : les en-têtes de la 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**********"
     }

   • Paramètres de requête : les paramètres de la requête. Utilisez l’ éditeur de dictionnaire pour ajouter de nouveaux paramètres.
     • Exemple : query value "select * from Vendor" (pour QuickBooks Online).
   • Corps : disponible pour toutes les méthodes HTTP à l’exception de GET, OPTIONS 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. Déboguez 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 Configuration du débogage , puis collez et enregistrez la syntaxe JSON suivante dans la section Arguments du projet :

{
  "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)

   • 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. Déboguez le workflow pour exécuter l’activité.
5. Vérifiez le panneau Sortie pour examiner la réponse HTTP.