Invia e ricevi richieste HTTP direttamente in XMLSpy
Il protocollo HTTP definisce come i file (testi, immagini, ecc.) vengono trasmessi su Internet. Ogni server web esegue un processo (daemon) che attende continuamente le richieste HTTP e le gestisce non appena arrivano.
Il protocollo HTTP è privo di stato, il che significa che ogni comando HTTP viene eseguito in modo indipendente, senza alcun riferimento ai comandi precedenti o successivi, e questo può rendere complessi i processi di test e debug.
Per aiutare gli sviluppatori in questo processo, la finestra di test HTTP in XMLSpy li guida attraverso le fasi di creazione e invio di una richiesta HTTP a un server web o a un'API. Successivamente, è possibile ricevere, verificare e risolvere eventuali problemi relativi alla risposta.
Una richiesta è definita nel pannello di sinistra della finestra e può essere composta da:
Una volta definita la richiesta, premere "Invia" per inviarla al server web. È possibile analizzare immediatamente la risposta nel pannello a destra, che mostra il contenuto e le informazioni dell'intestazione.
Nove schede separate nella finestra HTTP consentono di memorizzare e testare diversi messaggi, e di passare da uno all'altro in base alle esigenze.
XMLSpy consente anche di salvare direttamente le richieste HTTP nel modulo "HTTP Tester". Questo è utile per riutilizzare le stesse impostazioni o per scopi di documentazione. È inoltre possibile salvare la risposta HTTP in un file o copiarla in un nuovo documento per elaborarla ulteriormente, ad esempio, per generare automaticamente uno schema JSON o XML basato sulla struttura della risposta.
È inoltre possibile avviare un test importando una richiesta da un file WADL (Web Application Description Language), che fornisce una descrizione leggibile dalle macchine di un'applicazione basata su HTTP, oppure da un documento WSDL che descrive gli endpoint di un servizio web SOAP.
La finestra HTTP di XMLSpy include una procedura guidata per l'importazione di file WADL/WSDL, che vi guiderà attraverso l'apertura di un file, la selezione di una richiesta da testare e la modifica di eventuali parametri modificabili della richiesta.
Successivamente, la richiesta viene importata nella finestra HTTP, consentendo di inviarla e visualizzare la risposta.
La finestra rende altrettanto semplice eseguire test e.. debuggare le API REST.
La finestra HTTP permette di creare e testare richieste a partire da un documento OpenAPI che descrive un'API. È sufficiente indicare la posizione del documento OpenAPI, e la finestra HTTP visualizzerà i percorsi disponibili insieme alle relative operazioni. In base all'operazione e ai parametri selezionati, XMLSpy genera automaticamente il messaggio di test, che è possibile inviare all'API e visualizzare i risultati.
La finestra di test HTTP è utile anche per testare le richieste inviate a qualsiasi API di intelligenza artificiale importante, oltre che per analizzare i risultati dell'IA nell'ambito dell'ingegneria dei prompt.
Dopo aver inserito l'URL dell'endpoint dell'API di intelligenza artificiale, è possibile selezionare il tipo di contenuto, inserire la propria chiave API nell'intestazione di autorizzazione e, facoltativamente, aggiungere un'intestazione relativa all'organizzazione. Successivamente, inserire il corpo del messaggio e inviarlo all'endpoint dell'API.
In base alla risposta ottenuta, potrebbe essere necessario modificare la richiesta per ottenere risultati migliori. Ad esempio, si potrebbe modificare il testo presente nel campo della richiesta all'interno del payload JSON, oppure sperimentare con parametri diversi per perfezionare il risultato.
Dopo aver apportato delle modifiche, è possibile inviare nuovamente la richiesta, esaminare la nuova risposta e ripetere questo processo per migliorare iterativamente la qualità e la pertinenza dei risultati prodotti dall'intelligenza artificiale.
Utilizzare il tester HTTP per configurare e inviare richieste HTTP a un'API di intelligenza artificiale semplifica l'esecuzione di test approfonditi e l'affinamento delle istruzioni in linguaggio naturale. Grazie alla possibilità di definire e modificare con precisione i dati delle richieste, sperimentare con diversi parametri e visualizzare istantaneamente risposte dettagliate, gli sviluppatori possono facilmente ottimizzare la progettazione delle istruzioni durante la creazione di soluzioni basate sull'intelligenza artificiale.



