Verzend en ontvang HTTP-verzoeken rechtstreeks 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:
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.
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.
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.
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.
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.
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.
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.




