Requêtes HTTP à partir d’OpenAPI
Dans XMLSpy, vous pouvez créer des requêtes HTTP à partir d’un document OpenAPI à l’aide de l’assistant OpenAPI de la fenêtre HTTP.
Créer des requêtes HTTP
À partir du document OpenAPI, l’assistant crée et envoie la requête en trois étapes principales :
1.Sélectionnez une opération à partir d’un chemin décrit dans le fichier OpenAPI.
2.En fonction de l’opération, spécifiez le type de contenu du corps de la requête et/ou les paramètres de la requête.
3.Envoyez la requête. La réponse s’affichera dans le volet Info de la fenêtre de sortie HTTP.
La procédure ci-dessous explique comment créer une requête HTTP GET à partir d’un fichier OpenAPI et l’envoyer à un service web.
1.Dans la fenêtre HTTP, cliquez sur Créer une requête HTTP à partir de WSDL, WADL ou OpenAPI 
.
2.Dans le dialogue qui s'affiche, entrez l'emplacement du fichier de document OpenAPI et cliquez sur OK. Par exemple : https://petstore3.swagger.io/api/v3/openapi.json.
3.Dans le dialogue suivant, Sélectionner une opération (capture d’écran ci-dessous), sélectionnez le chemin d'accès et l'opération souhaités. Par exemple, dans la capture d'écran ci-dessous, le chemin sélectionné est /pet/findByStatus et son opération GET est l'opération sélectionnée. (Notez que, dans le dialogue, vous pouvez filtrer les chemins d’accès et trier les éléments affichés.)
4.Lorsque vous cliquez sur OK, le dialogue Paramètres de requête HTTP s'affiche (capture d'écran ci-dessous). Les valeurs qui ont été définies dans le document OpenAPI pour ce paramètre s'affichent dans la liste déroulante de la colonne Valeurs. Sélectionnez la valeur souhaitée et cliquez sur OK.
5.La requête GET sera créée et son URI s'affichera en haut de la fenêtre HTTP (voir la capture d'écran ci-dessous).
6.Lorsque vous cliquez sur Envoyer, la requête sera envoyée et la réponse s'affichera dans le volet Résultats à droite (voir la capture d'écran ci-dessous).
Pour plus d'informations, voir également les rubriques HTTP suivantes : Envoyer la requête et Recevoir la réponse. La sélection du type de contenu par l'assistant pour les requêtes PUT et POST est décrite dans la section Envoyer la requête.
Requêtes HTTP à partir de la vue Texte ou de la vue Grille
Si un fichier OpenAPI est ouvert dans la vue Texte ou la vue Grille, vous pouvez créer une requête HTTP directement à partir de n'importe quel emplacement du document. Pour ce faire, cliquez avec le bouton droit de la souris sur l'emplacement souhaité et sélectionnez la commande du menu contextuel Nouvelle requête HTTP. (capture d'écran ci-dessous).
L'assistant effectuera automatiquement les étapes de sa procédure en fonction de l'emplacement choisi et vous pourrez poursuivre avec l'assistant à partir de l'étape suivante. Par exemple, dans la capture d'écran ci-dessus, nous cliquons avec le bouton droit sur le chemin /pet/findByStatus pour créer une requête correspondant à l'une des opérations de ce chemin. De ce fait, l'assistant dispose des informations relatives au chemin d'accès issues du document OpenAPI. Il sait également que ce chemin d'accès propose une seule opération, une opération GET, qui prend un paramètre (status). Comme une seule opération (GET) est possible, l'assistant s'ouvre directement à l'étape Paramètres afin que vous puissiez saisir la valeur du paramètre status (capture d'écran ci-dessous). En cliquant sur OK, la requête HTTP d’exemple sera créée et prête à être envoyée.
L’assistant s’ouvrira à la première étape où plusieurs choix sont possibles. S’il n’y a aucune ambiguïté à toutes les étapes (par exemple, une seule opération et aucun paramètre), alors une requête d’exemple est créée immédiatement et vous pouvez l’envoyer sans attendre (en cliquant sur Envoyer) ; vous pouvez également modifier la requête avant de l’envoyer.
Requêtes HTTP multipart à partir d’un fichier OpenAPI
Dans un fichier OpenAPI, si la description d’une requête POST nécessite le téléchargement de plusieurs fichiers ou d’un mélange de données (par exemple, des données JSON et binaires), l’assistant OpenAPI créera la requête POST sous la forme d’une requête multipart/form-data. Vous pouvez créer la requête à partir de la fenêtre HTTP, de la vue Texte ou de la vue Grille ; la procédure est similaire à celles décrites ci-dessus.
Lorsque vous sélectionnez la description d’une opération POST nécessitant plusieurs entrées, l’assistant vous guide, éventuellement via des étapes préliminaires, jusqu’à l’étape où vous saisissez les valeurs des différentes parties form-data de la requête multipart. Cette étape de l’assistant se présente sous la forme d’une vue en grille dans laquelle chaque ligne de la grille représente une partie form-data (voir la capture d’écran ci-dessous). Après avoir saisi les valeurs, vous pouvez vérifier les paramètres de la requête, puis envoyer celle-ci.
La capture d’écran ci-dessous présente les paramètres d’une requête POST multipart basée sur une description OpenAPI. Une fois la requête envoyée, la réponse s’affiche dans le volet de droite.
Voir également Envoyer la requête pour plus d’informations sur le type de contenu multipart/form-data dans la fenêtre de sortie HTTP.