Fenêtre de test HTTP

Envoyer et Recevoir des Requêtes directement dans XMLSpy

  • Test de protocole HTTP
  • Requêtes multipart/form-data pour l'envoi de fichiers
  • Recevoir, vérifier et dépanner des réponses
  • Fenêtre à neuf onglets pour tester de multiples messages
  • Générer des requêtes à partir de fichiers OpenAPI
  • Consulter l’en-tête et le corps de la réponse
  • Tester des réponses API des services web REST/SOAP
  • Tester des réponses API IA et l’ingénierie facile

Test de protocole HTTP

Tester une requête/réponse HTTP dans XMLSpy

Le protocole HTTP définit comment les fichiers (texte, images, etc.) sont transmis par Internet. Chaque serveur web exécute un daemon qui attend continuellement les requêtes HTTP et gère chacune quand elle arrive.

Le protocole HTTP est sans état, ce qui signifie que chaque commande HTTP est exécutée indépendamment, sans aucune référence aux commandes précédentes ou suivantes — et ceci peut représenter un défi pour le test et le débogage.

Pour aider les développeurs en la matière, la fenêtre de test HTTP dans XMLSpy vous guide à travers le processus de création et d’envoi d’une requête HTTP vers le serveur web ou API. Puis, vous pouvez recevoir, vérifier et dépanner la réponse.

Une requête est définie dans le volet gauche de la fenêtre et peut consister en :

  • Une méthode HTTP de la requête (GET, PUT, POST, etc.) et l’URL cible
  • Les en-têtes HTTP de la requête
  • Paramètres de connexion, par exemple les délais d'expiration et les options de sécurité
  • Pour les méthodes POST et PUT, le corps du message HTTP

Une fois que la requête est définie, appuyez sur Envoyer pour l’envoyer au serveur web. Vous pouvez analyser la réponse immédiatement dans le volet droit, qui affiche le corps et l’en-tête de l’info.

Neuf onglets séparés dans la fenêtre HTTP vous permettent de stocker et tester de multiples messages et de les basculer entre eux, tel que requis.

XMLSpy vous permet également d’enregistrer vos requêtes HTTP directement dans le testeur HTTP. Ceci est utile pour réutiliser la même configuration à des fins de documentation. Vous pouvez également enregistrer la réponse HTTP dans un fichier ou la copier dans un nouveau document pour travailler avec un peu plus tard, par ex., pour générer automatiquement un schéma JSON ou XML basé sur la structure d’une réponse.

Requêtes multipart et envois de fichiers

La fenêtre de test HTTP prend en charge les requêtes POST et PUT de type multipart/form-data, qui constituent la méthode standard utilisée par les API web pour accepter les envois de fichiers et les requêtes combinant plusieurs types de données (tels que des champs de texte, du JSON et des fichiers binaires) au sein d’un même message.

Les aides à la saisie facilitent la création d'une requête multipart. Pour chaque partie, vous spécifiez un nom, indiquez s'il s'agit d'une valeur textuelle ou d'un fichier, définissez son type de contenu, puis saisissez le texte ou sélectionnez le fichier à télécharger. Vous pouvez ajouter autant de parties que l'API en prévoit ; ainsi, télécharger plusieurs fichiers à la fois ou envoyer un fichier accompagné de ses métadonnées JSON ne nécessite que de remplir quelques lignes.

POST HTTP multipart/form-data

Test des messages OpenAPI

La fenêtre HTTP permet de créer et de tester des requêtes à partir d'un document OpenAPI qui décrit une API. Il suffit d'entrer l'emplacement du document OpenAPI pour que la fenêtre HTTP affiche les chemins disponibles avec les opérations correspondantes. En fonction de l'opération et des paramètres que vous sélectionnez, XMLSpy génère automatiquement le message de test, que vous pouvez envoyer à l'API, puis afficher les résultats.

Envoi d'un message de test basé sur OpenAPI

Vous pouvez également partir du fichier OpenAPI lui-même : cliquez avec le bouton droit sur n’importe quelle opération pendant l’édition, et XMLSpy ouvre une requête prête à être envoyée dans la fenêtre de test HTTP, avec le chemin d’accès, la méthode, les paramètres et le corps de la requête déjà renseignés.

Lorsqu’une opération attend un corps de type multipart/form-data, XMLSpy lit le schéma et pré-remplit les parties attendues, y compris leurs noms et leurs types ; il ne vous reste plus qu’à ajouter les valeurs et les chemins d’accès aux fichiers, puis à envoyer la requête.

Test API IA & ingénierie rapide

La fenêtre de test HTTP est également utile pour tester les requêtes dans toutes les principales API IA ainsi qu’analyser les résultats IA pour une ingénierie rapide.

Après avoir saisi l’URL pour le point final API IA, vous pouvez sélectionner le type du contenu, saisir votre clé API dans l’en-tête de l’Autorisation et ajouter en option une en-tête d’organisation. Puis, saisissez le corps du message et envoyez-le au point final de l’API.

Basé sur la réponse, vous allez éventuellement devoir adapter l’invite pour avoir de meilleurs résultats. Par exemple, vous allez éventuellement devoir ajuster la langue dans le champ d’invite de la charge utile de JSON ou expérimenter avec différents paramètres pour affiner la sortie.

Après avoir fait les changements, vous pouvez renvoyer la requête et revoir la nouvelle réponse et répéter ce processus pour améliorer de manière itérative la qualité et la pertinence de la sortie IA.

Ingénierie rapide en testant la réponse API IA dans XMLSpy

Utiliser le testeur HTTP pour configurer et envoyer les requêtes HTTP vers une API IA facilite la réalisation des tests complets et affine les invites du langage naturel. Avec la capacité à élaborer et affiner les charges utiles de manière précise, expérimentez avec différents paramètres, et consulter des réponses détaillées de manière instantanée, les développeurs peuvent facilement affiner l’ingénierie des invites lorsqu’ils créent des solutions pilotées par l’IA.

Assistant d’importation WADL/WSDL

Vous pouvez également initier un test en important une requête d’un fichier WADL (Web Application Description Language), qui fournit une description d’une application basée sur HTTP lisible à la machine, ou un document WSDL décrivant les points finaux du service web SOAP.

La fenêtre HTTP XMLSpy inclut un assistant d’importation WADL/WSDL qui vous guide à travers l’ouverture d’un fichier, la sélection qu’une requête pour tester, et la modification de tout paramètre éditable de la requête.

Puis, il importe la requête dans la fenêtre HTTP pour que vous puissiez l’envoyer et revoir la réponse.

Tester un message WADL ou WSDL dans XMLSpy