Requête brute

Cette méthode effectue une requête HTTP brute, ce qui vous permet, en tant que générateur de flux, de contrôler tous les aspects de la requête HTTP. Cela permet à un flux d'appeler un service XML, un service HTML, ou diverses autres utilisations avancées.

Les autres fonctions de Connecteur API sont optimisées pour faciliter l'utilisation avec les services typiques basés sur JSON. La carte de fonction Requête brute est plus flexible.

Voici quelques cas d'utilisation de cette carte de fonction :

• Appeler un service XML : Utilisez la carte de fonction Construire du code XML pour créer une chaîne XML contenant votre requête et faites-la glisser dans l'entrée corps de la carte de fonction Requête brute. Utilisez ensuite la fonction Analyser du code XML pour analyser la sortie Corps et créer une réponse JSON que vous pourrez ensuite utiliser pour le reste de votre flux. Cela fonctionne également avec un service HTML.

• Appeler une API JSON avec une liste : La fonction API Connector Post impose implicitement de transmettre un objet JSON dans le corps. Chaque entrée que vous créez dans la section Corps devient une clé dans le corps de la requête. Si vous souhaitez transmettre d'autre qu'un objet, comme une liste d'objets, vous pouvez le faire en utilisant la carte de fonction Requête brute. Créez la liste de votre choix à l'aide des fonctions Liste, puis appelez la carte de fonction Convertir en chaîne JSON pour créer une chaîne, puis faites-la glisser vers l'entrée Corps de la carte de fonction Requête brute.

• Construire une requête de manière programmatique : Vous pouvez avoir une logique qui détermine votre chaîne de requête au moment de l'exécution. Utilisez les cartes de fonction Objet pour créer un objet de requête dans votre flux, puis faites glisser votre objet vers l'entrée Requête de la carte de fonction Requête brute. L'objet de requête est converti en chaîne de requête URL : Si votre objet de requête est { "x": "one", "y": "two"}, alors la chaîne de requête est : ?x=one&y=two.

• Créer les en-têtes par programme : les autres fonctions de Connecteur API vous obligent implicitement à définir les noms de vos champs d'en-tête au moment de la conception. Les valeurs peuvent être dynamiques, mais les noms des champs d'en-tête sont fixes. Si vous souhaitez les définir dans le flux, utilisez les cartes de fonction Objet pour créer un objet En-têtes dans votre flux, puis faites glisser votre objet vers l'entrée En-têtes de la carte de fonction Requête brute. Par exemple, si l'objet des en-têtes est { "Accept": "text/plain" }, la chaîne d'en-tête pour la requête est Accept: text/plain.

• Appeler une API JSON avec des clés dynamiques : La fonction Post des connecteurs API vous force implicitement à créer les clés dans le corps de la requête au moment de la conception. Si vous souhaitez les créer au moment de l'exécution, en fonction des paramètres d'entrée, créez l'objet à l'aide des cartes de fonction Objet, transmettez-le à la carte de fonction Convertir en chaîne JSON, puis faites glisser cette chaîne dans l'entrée Corps de la carte de fonction Requête brute.

La carte de fonction Requête brute est suffisamment flexible pour former n'importe quelle requête HTTP. Si les autres fonctions HTTP ne disposent pas de la flexibilité dont vous avez besoin, utilisez la carte de fonction Requête brute à la place.

Entrée

Sortie