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.
La finestra di test HTTP supporta le richieste POST e PUT con formato multipart/form-data, che è il metodo standard utilizzato dalle API web per accettare l'invio di file e le richieste che combinano diversi tipi di dati, come campi di testo, JSON e file binari, in un'unica trasmissione.
Gli strumenti per la creazione di richieste complesse semplificano notevolmente il processo. Per ogni parte della richiesta, è necessario specificare un nome, indicare se si tratta di un valore di testo o di un file, impostare il tipo di contenuto e inserire il testo oppure selezionare il file da caricare. È possibile aggiungere tutte le parti che l'API richiede, quindi caricare più file contemporaneamente o inviare un file insieme ai suoi metadati JSON è semplicemente una questione di compilare alcuni campi.
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.
È possibile anche partire direttamente dal file OpenAPI: facendo clic con il tasto destro su qualsiasi operazione durante la modifica, XMLSpy apre una richiesta pronta per essere inviata nella finestra di test HTTP, con il percorso, il metodo, i parametri e il corpo della richiesta già compilati.
Quando un'operazione si aspetta un corpo di dati in formato multipart/form-data, XMLSpy legge lo schema e precompila le parti previste, inclusi i loro nomi e tipi, in modo che l'utente debba solo aggiungere i valori e i percorsi dei file e inviare.
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.
È 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.




