Finestra di test HTTP

Invia e ricevi richieste HTTP direttamente in XMLSpy

  • Test del protocollo HTTP
  • Richieste di tipo "multipart/form-data" per il caricamento di file
  • Ricevere, verificare e risolvere eventuali problemi relativi alle risposte
  • Finestra con nove schede per testare più messaggi contemporaneamente
  • Generare richieste a partire da file OpenAPI
  • Visualizza l'intestazione e il corpo della risposta
  • Testare le risposte delle API dei servizi web REST/SOAP
  • Testare le risposte delle API di intelligenza artificiale e ottimizzare la formulazione delle richieste

Test del protocollo HTTP

Testare le richieste e le risposte HTTP 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:

  • Il metodo HTTP della richiesta (GET, PUT, POST, ecc.) e l'URL di destinazione
  • Intestazioni HTTP della richiesta
  • Impostazioni di connessione, ad esempio, timeout e opzioni di sicurezza
  • Per i metodi POST e PUT, il corpo del messaggio HTTP

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.

Richieste multiple e caricamento di file

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.

Richiesta HTTP POST con dati inviati in formato multipart

Testare i messaggi OpenAPI

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.

Invia un messaggio di prova basato su OpenAPI

È 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.

Test delle API di intelligenza artificiale e progettazione di prompt

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.

Ottimizzazione delle istruzioni per l'intelligenza artificiale tramite test delle risposte dell'API in XMLSpy

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.

Assistente di importazione per file WADL/WSDL

È 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.

Testare un messaggio WADL o WSDL in XMLSpy