HTTP-testvenster

Verzend en ontvang HTTP-verzoeken rechtstreeks in XMLSpy

  • Testen van het HTTP-protocol
  • Verzoeken met het type "multipart/form-data" voor het uploaden van bestanden
  • Ontvang, controleer en los problemen op met de antwoorden
  • Een venster met negen tabbladen voor het testen van meerdere berichten
  • Genereer verzoeken op basis van OpenAPI-bestanden
  • Bekijk de antwoordkoptekst en -inhoud
  • Het testen van API-antwoorden van REST- en SOAP-webservices
  • Het testen van antwoorden van AI-API's en het optimaliseren van de instructies (prompts)

Testen van het HTTP-protocol

Het testen van HTTP-verzoeken en -antwoorden in XMLSpy

Het HTTP-protocol definieert hoe bestanden (tekst, afbeeldingen, enz.) via het internet worden verzonden. Elke webserver draait een proces dat continu wacht op HTTP-verzoeken en elk verzoek verwerkt zodra het binnenkomt.

Het HTTP-protocol is "stateless", wat betekent dat elk HTTP-commando onafhankelijk wordt uitgevoerd, zonder enige verwijzing naar eerdere of volgende commando's – en dit kan het testen en debuggen bemoeilijken.

Om ontwikkelaars hierbij te helpen, begeleidt het HTTP-testvenster in XMLSpy u door het proces van het maken en verzenden van een HTTP-verzoek naar een webserver of API. Vervolgens kunt u de reactie ontvangen, controleren en eventuele problemen oplossen.

Een verzoek wordt gedefinieerd in het linkerpaneel van het venster en kan bestaan uit:

  • De HTTP-methode van de aanvraag (GET, PUT, POST, enz.) en de doel-URL
  • De HTTP-headers van de aanvraag
  • Verbindingsinstellingen, zoals time-outs en beveiligingsopties
  • Voor de HTTP-methoden POST en PUT is het inhouddeel van het HTTP-bericht van belang

Zodra het verzoek is gedefinieerd, klikt u op "Verzenden" om het naar de webserver te sturen. U kunt de reactie direct analyseren in het rechterpaneel, dat de inhoud en de headerinformatie weergeeft.

Negen afzonderlijke tabbladen in het HTTP-venster stellen u in staat om meerdere berichten op te slaan en te testen, en om indien nodig tussen deze berichten te wisselen.

XMLSpy stelt u ook in staat om uw HTTP-verzoeken direct op te slaan in de HTTP-tester. Dit is handig om dezelfde configuratie opnieuw te gebruiken of voor documentatie. U kunt ook de HTTP-reactie opslaan in een bestand of deze kopiëren naar een nieuw document om er verder mee te werken, bijvoorbeeld om automatisch een JSON- of XML-schema te genereren op basis van de structuur van de reactie.

Multideeltrajecten en het uploaden van bestanden

Het HTTP-testvenster ondersteunt multipart/form-data POST- en PUT-verzoeken, de standaardmethode waarmee web-API's bestanden uploaden en verzoeken verwerken die verschillende soorten gegevens combineren, zoals tekstvelden, JSON en binaire bestanden, in één bericht.

Hulpfuncties maken het eenvoudig om een verzoek met meerdere onderdelen te maken. Voor elk onderdeel kunt u een naam opgeven, kiezen of het een tekstwaarde of een bestand is, het inhoudstype instellen en vervolgens de tekst invoeren of het bestand selecteren dat u wilt uploaden. U kunt zoveel onderdelen toevoegen als de API verwacht, dus het uploaden van meerdere bestanden tegelijkertijd, of het verzenden van een bestand samen met de bijbehorende JSON-metadata, is simpelweg een kwestie van het invullen van een paar velden.

Multipart form-data HTTP POST-verzoek

Het testen van OpenAPI-berichten

Het HTTP-venster kan verzoeken aanmaken en testen op basis van een OpenAPI-document dat een API beschrijft. U hoeft alleen de locatie van het OpenAPI-document in te voeren, waarna het HTTP-venster de beschikbare paden met hun bijbehorende bewerkingen weergeeft. Op basis van de bewerking en de parameters die u selecteert, genereert XMLSpy automatisch het testbericht, dat u naar de API kunt sturen en waarvan u vervolgens de resultaten kunt bekijken.

Verstuur een testbericht op basis van de OpenAPI-specificatie

U kunt ook direct vanuit het OpenAPI-bestand beginnen: klik met de rechtermuisknop op een willekeurige bewerking tijdens het bewerken, en XMLSpy opent een kant-en-klaar verzoek in het HTTP-testvenster, waarbij het pad, de methode, de parameters en de aanvraagtekst al zijn ingevuld.

Wanneer een operatie een `multipart/form-data`-inhoud verwacht, leest XMLSpy het schema en vult de verwachte onderdelen alvast in, inclusief hun namen en types. U hoeft dan alleen nog waarden en bestandspaden toe te voegen en de data te verzenden.

AI-API-testen en promptontwikkeling

Het HTTP-testvenster is ook handig voor het testen van verzoeken naar vrijwel elke belangrijke AI-API, evenals voor het analyseren van AI-resultaten bij het ontwikkelen van prompts.

Nadat u de URL voor het AI-API-eindpunt hebt ingevoerd, kunt u het inhoudstype selecteren, uw API-sleutel invoeren in een "Authorization"-header en eventueel een "organization"-header toevoegen. Vervolgens kunt u de inhoud van de boodschap invoeren en deze naar het API-eindpunt verzenden.

Afhankelijk van het resultaat, moet u mogelijk de instructie aanpassen om betere resultaten te krijgen. U kunt bijvoorbeeld de taal in het instructieveld van de JSON-data wijzigen, of experimenteren met verschillende parameters om het resultaat te verfijnen.

Nadat u wijzigingen heeft aangebracht, kunt u het verzoek opnieuw verzenden en de nieuwe reactie bekijken. U kunt dit proces herhalen om de kwaliteit en relevantie van de output van de AI geleidelijk te verbeteren.

Het optimaliseren van prompts door de reacties van een AI-API in XMLSpy te testen

Met de HTTP-tester kunt u eenvoudig HTTP-verzoeken configureren en verzenden naar een AI-API, waardoor uitgebreide tests mogelijk zijn en natuurlijke taalprompts verfijnd kunnen worden. Dankzij de mogelijkheid om verzoekgegevens nauwkeurig te bewerken en aan te passen, te experimenteren met verschillende parameters en direct gedetailleerde antwoorden te bekijken, kunnen ontwikkelaars prompt engineering eenvoudig verbeteren bij het ontwikkelen van AI-gestuurde oplossingen.

Wizard voor het importeren van WADL/WSDL-bestanden

U kunt ook een test starten door een verzoek te importeren vanuit een WADL-bestand (Web Application Description Language), dat een machineleesbare beschrijving van een HTTP-gebaseerde applicatie biedt, of een WSDL-document dat SOAP-webservices eindpunten beschrijft.

Het HTTP-venster van XMLSpy bevat een begeleide importfunctie voor WADL/WSDL, die u stap voor stap helpt bij het openen van een bestand, het selecteren van een verzoek voor testen en het aanpassen van eventuele bewerkbare parameters van dat verzoek.

Vervolgens importeert het de aanvraag in het HTTP-venster, zodat u deze kunt verzenden en de reactie kunt bekijken.

Test een WADL- of WSDL-bericht in XMLSpy