Esercitazione: Simulare le risposte dell'API
SI APPLICA A: Tutti i livelli di Gestione API
Le API back-end vengono importate in un'API di Gestione API o create e gestite manualmente. I passaggi di questa esercitazione illustrano come:
- Usare Gestione API per creare un'API HTTP vuota
- Gestire manualmente un'API HTTP
- Impostare un criterio in un'API in modo che restituisca una risposta fittizia
Questo metodo consente agli sviluppatori di proseguire con l'implementazione e il test dell'istanza di Gestione API anche se il back-end non è disponibile per inviare risposte reali.
La possibilità di simulare le risposte è utile in molti scenari:
- Quando la facciata dell'API viene progettata prima e l'implementazione del back-end viene eseguita in seguito o quando il back-end viene sviluppato in parallelo.
- Quando il back-end è temporaneamente non operativo o non è possibile ridimensionarlo.
In questa esercitazione apprenderai a:
- Creare un'API di test
- Aggiungere un'operazione all'API di test
- Abilitare la simulazione della risposta
- Testare l'API fittizia
Prerequisiti
- Acquisire familiarità con la terminologia di Gestione API di Azure.
- Comprendere il concetto di criteri in Gestione API di Azure.
- Completare la guida introduttiva seguente: Creare un'istanza di Gestione API di Azure.
Creare un'API di test
I passaggi descritti in questa sezione illustrano come creare un'API HTTP senza back-end.
Accedere al portale di Azure, quindi passare all'istanza di Gestione API.
Selezionare API>+ Aggiungi API>Riquadro HTTP.
Nella finestra Crea un'API HTTP selezionare Completa.
Immettere Test API in Nome visualizzato.
Selezionare Senza limiti per Prodotti.
Assicurarsi che Gestito sia selezionato per Gateway.
Seleziona Crea.
Aggiungere un'operazione all'API di test
Un'API espone una o più operazioni. In questa sezione si aggiungerà un'operazione all'API HTTP creata. La chiamata all'operazione al termine dei passaggi descritti in questa sezione genera un errore. Dopo aver completato i passaggi descritti nella sezione Abilitare la simulazione della risposta, non verranno visualizzati errori.
Selezionare l'API creata nel passaggio precedente.
Selezionare + Aggiungi operazione.
Nella finestra Front-end immettere i valori seguenti.
Impostazione valore Descrizione Nome visualizzato Test call Nome visualizzato nel portale per sviluppatori. URL (verbo HTTP) GET Selezionare uno dei verbi HTTP predefiniti. URL test/ Percorso URL per l'API. Descrizione Descrizione facoltativa dell'operazione usata per fornire la documentazione necessaria agli sviluppatori che usano questa API nel portale per sviluppatori. Selezionare la scheda Risposte, sotto i campi URL, Nome visualizzato e Descrizione. In questa scheda immettere le impostazioni per definire schemi, esempi, tipi di contenuto e codici di stato della risposta.
Selezionare + Aggiungi risposta e selezionare 200 OK dall'elenco.
Sotto l'intestazione Rappresentazioni a destra selezionare + Aggiungi rappresentazione.
Immettere application/json nella casella di ricerca e selezionare il tipo di contenuto application/json.
Nella casella di testo Sample (Esempio) immettere
{ "sampleField" : "test" }
.Seleziona Salva.
Sebbene non sia richiesto per questo esempio, è possibile configurare più impostazioni per un'operazione API in altre schede, ad esempio:
Scheda | Descrizione |
---|---|
Query | Consente di aggiungere parametri di query. Oltre al nome e alla descrizione, è possibile specificare anche i valori che da assegnare a un parametro di query. È possibile contrassegnare uno dei valori come predefinito (facoltativo). |
Richiedi | Consente di definire schemi, esempi e tipi di contenuto della richiesta. |
Abilitare la simulazione della risposta
Selezionare l'API creata nel passaggio Creare un'API di test.
Nella finestra a destra, assicurarsi che la scheda Progettazione sia selezionata.
Selezionare l'operazione di test aggiunta.
Nella finestra Elaborazione in ingresso fare clic su + Aggiungi criteri.
Selezionare Mock responses (Simula risposte) dalla raccolta.
Nella casella di testo API Management response (Risposta di Gestione API) digitare 200 OK, application/json. Questa selezione indica che l'API deve restituire l'esempio di risposta definito nella sezione precedente.
Seleziona Salva.
Suggerimento
Viene visualizzata una barra gialla con il testo Simulazione abilitata. Ciò indica che le risposte restituite da Gestione API sono simulate dal criterio fittizio e non sono prodotte dal back-end.
Testare l'API fittizia
Selezionare l'API creata nel passaggio Creare un'API di test.
Selezionare la scheda Test.
Assicurarsi che l'API Test call sia selezionata, quindi selezionare Invia per effettuare una chiamata di test.
La risposta HTTP visualizza il codice JSON fornito come esempio nella prima sezione dell'esercitazione.
Passaggi successivi
Questa esercitazione ha descritto come:
- Creare un'API di test
- Aggiungere un'operazione all'API di test
- Abilitare la simulazione della risposta
- Testare l'API fittizia
Passare all'esercitazione successiva: