Postman Tutorial

Cosa è Postman?

Postman è uno strumento di test API scalabile che si integra rapidamente in una pipeline CI/CD. È nato nel 2012 come progetto parallelo di Abhinav Asthana per semplificare il flusso di lavoro API nei test e nello sviluppo. API è l'acronimo di Application Programming Interface, un'interfaccia di programmazione delle applicazioni che consente alle applicazioni software di comunicare tra loro tramite chiamate API.

👉 Iscriviti al progetto di test API live gratuito

Perché usare Postman?

Con oltre 4 milioni di utenti al giorno d'oggi, Postman Il software è diventato uno strumento preferito per i seguenti motivi:

1. Accessibilità – Per utilizzare il Postman strumento, basterebbe semplicemente accedere al proprio account, rendendo facile l'accesso ai file sempre e ovunque, purché un Postman l'applicazione è installata sul computer.
2. Utilizzo delle collezioni – Postman consente agli utenti di creare raccolte per i propri Postman Chiamate API. Ogni raccolta può creare sottocartelle e richieste multiple. Questo aiuta a organizzare le suite di test.
3. Collaborazione: è possibile importare o esportare raccolte e ambienti, semplificando la condivisione dei file. È anche possibile utilizzare un collegamento diretto per condividere le raccolte.
4. Creazione di ambienti: avere più ambienti aiuta a ridurre la ripetizione dei test, poiché è possibile utilizzare la stessa raccolta ma per un ambiente diverso. È qui che avrà luogo la parametrizzazione, di cui parleremo nelle lezioni successive.
5. Creazione di test: è possibile aggiungere punti di controllo dei test, come la verifica dello stato di risposta HTTP riuscita, a ciascuno Postman Chiamate API, che aiutano a garantire copertura di prova.
6. Test di automazione: tramite l'uso di Collection Runner o Newman, i test possono essere eseguiti in più iterazioni, risparmiando tempo sui test ripetitivi.
7. Debug – Postman La console aiuta a verificare quali dati sono stati recuperati, semplificando il debug dei test.
8. Integrazione continua – Grazie alla sua capacità di supportare l’integrazione continua, le pratiche di sviluppo vengono mantenute.

Come si usa Postman per eseguire le API

Di seguito è il Postman Area di lavoro. Esploriamo il processo passo dopo passo su Come si usa Postman e diverse caratteristiche del Postman attrezzo!

1. Nuovo: qui puoi creare una nuova richiesta, una nuova raccolta o un nuovo ambiente.
2. Importa – Questa opzione consente di importare una raccolta o un ambiente. Sono disponibili opzioni come l'importazione da file, cartella, collegamento o l'incollamento di testo non elaborato.
3. Runner – I test di automazione possono essere eseguiti tramite il Collection Runner. Di questo si parlerà più approfonditamente nella prossima lezione.
4. Apri nuovo: apre una nuova scheda, Postman Finestra o Finestra Runner cliccando su questo pulsante.
5. Il mio spazio di lavoro: puoi creare un nuovo spazio di lavoro individualmente o in gruppo.
6. Invita: collabora su uno spazio di lavoro invitando i membri del team.
7. Cronologia: le richieste passate che hai inviato verranno visualizzate nella Cronologia. Ciò semplifica il monitoraggio delle azioni eseguite.
8. Raccolte: organizza la tua suite di test creando raccolte. Ogni raccolta può contenere sottocartelle e più richieste. Una richiesta o una cartella può anche essere duplicata.
9. Scheda Richiesta: mostra il titolo della richiesta su cui stai lavorando. Per impostazione predefinita, per le richieste senza titoli verrà visualizzato "Richiesta senza titolo".
10. Richiesta HTTP: facendo clic su questo verrà visualizzato un elenco a discesa di diverse richieste, come GET, POST, COPY, DELETE, ecc. In Postman Test API, le richieste più comunemente utilizzate sono GET e POST.
11. URL di richiesta: noto anche come endpoint, è qui che identificherai il collegamento con cui l'API comunicherà.
12. Salva: se sono presenti modifiche a una richiesta, è necessario fare clic su Salva in modo che le nuove modifiche non vengano perse o sovrascritte.
13. Parametri: qui scriverai i parametri necessari per una richiesta, come i valori delle chiavi.
14. Autorizzazione: per accedere alle API è necessaria un'autorizzazione appropriata. Questa può essere fornita tramite nome utente e password, token di controllo, ecc.
15. Intestazioni: è possibile impostare intestazioni come il tipo di contenuto JSON, a seconda delle esigenze dell'organizzazione.
16. Corpo: qui è possibile personalizzare i dettagli di una richiesta, comunemente utilizzato in una richiesta POST.
17. Script pre-richiesta: si tratta di script che verranno eseguiti prima della richiesta. Di solito, vengono utilizzati script pre-richiesta per l'ambiente di impostazione per garantire che i test vengano eseguiti nell'ambiente corretto.
18. Test: si tratta di script eseguiti durante la richiesta. È importante disporre di test in quanto impostano checkpoint per verificare se lo stato della risposta è corretto, se i dati recuperati sono quelli previsti e altri test.

Utilizzo delle richieste GET

Le richieste Get vengono utilizzate per recuperare informazioni dall'URL specificato. Non verranno apportate modifiche all'endpoint.

Utilizzeremo il seguente URL per tutti gli esempi in questo Postman lezione https://jsonplaceholder.typicode.com/users

Nello spazio di lavoro

1. Imposta la tua richiesta HTTP su GET.
2. Nel campo URL della richiesta, inserisci il collegamento
3. Clicca Invia
4. Verrà visualizzato il messaggio "200 OK"
5. Nel corpo dovrebbero essere presenti 10 risultati utente, il che indica che il test è stato eseguito correttamente.

* Nota: Potrebbero esserci casi in cui il Get Postman La richiesta potrebbe non andare a buon fine. Ciò potrebbe essere dovuto a un URL di richiesta non valido o alla necessità di autenticazione.

Lavorare con le richieste POST

Le richieste POST sono diverse dalle richieste GET in quanto prevedono la manipolazione dei dati da parte dell'utente, che aggiunge dati all'endpoint. Utilizzando gli stessi dati del tutorial precedente sulla richiesta GET, aggiungiamo ora il nostro utente.

Passo 1) Fare clic su una nuova scheda per creare una nuova richiesta.

Passo 2) Nella nuova scheda

1. Imposta la tua richiesta HTTP su POST.
2. Inserisci lo stesso collegamento nell'URL della richiesta: https://jsonplaceholder.typicode.com/users
3. passare alla scheda Corpo

Passo 3) Nel corpo,

1. Fare clic su grezzo
2. Seleziona JSON

Passo 4) Copia e incolla un solo risultato utente dalla richiesta di recupero precedente come di seguito. Assicurati che il codice sia stato copiato correttamente abbinando parentesi graffe e parentesi graffe. Cambia l'ID in 11 e il nome con qualsiasi nome desiderato. Puoi anche modificare altri dettagli come l'indirizzo.

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "[email protected]",
        "address": {
            "street": "Kulas Light",
            "suite": "Apt. 556",
            "city": "Gwenborough",
            "zipcode": "92998-3874",
            "geo": {
                "lat": "-37.3159",
                "lng": "81.1496"
            }
        },
        "phone": "1-770-736-8031 x56442",
        "website": "hildegard.org",
        "company": {
            "name": "Romaguera-Crona",
            "catchPhrase": "Multi-layered client-server neural-net",
            "bs": "harness real-time e-markets"
        }
    }
]

* Nota: La richiesta di pubblicazione online deve avere il formato corretto per garantire che i dati richiesti vengano creati. È buona norma utilizzare prima Get per verificare il formato JSON della richiesta. È possibile utilizzare strumenti come https://jsonformatter.curiousconcept.com/

Passo 5) Il prossimo,

1. Clicca Invia.
2. Dovrebbe essere visualizzato Stato: 201 Creato
3. I dati pubblicati vengono visualizzati nel corpo.

Come parametrizzare le richieste

La parametrizzazione dei dati è una delle funzionalità più utili di PostmanInvece di creare le stesse richieste con dati diversi, è possibile utilizzare variabili con parametri. Questi dati possono provenire da un file di dati o da una variabile d'ambiente. La parametrizzazione aiuta a evitare la ripetizione degli stessi test e le iterazioni possono essere utilizzate per test di automazione.

I parametri vengono creati tramite l'uso di doppie parentesi graffe: {{sample}}. Diamo un'occhiata a un esempio di utilizzo dei parametri nella nostra richiesta precedente:

Ora creiamo una richiesta GET parametrizzata.

Passo 1)

1. Imposta la tua richiesta HTTP su GET
2. Inserisci questo link: https://jsonplaceholder.typicode.com/users. Sostituisci la prima parte del collegamento con un parametro come {{url}}. L'URL della richiesta ora dovrebbe essere {{url}}/users.
3. Fare clic su Invia.

Non dovrebbe esserci alcuna risposta poiché non abbiamo impostato la fonte del nostro parametro.

Passo 2) Per utilizzare il parametro è necessario impostare l'ambiente

1. Fare clic sull'icona dell'occhio
2. Fare clic su Modifica per impostare la variabile su un ambiente globale, che può essere utilizzato in tutte le raccolte.

Passo 3) Nella variabile,

1. imposta il nome sull'URL che è https://jsonplaceholder.typicode.com
2. fare clic su Salva.

Passo 4) Fai clic su Chiudi se vedi la schermata successiva

Passo 5) Torna alla tua richiesta Get, quindi clicca su Invia. Ora dovresti avere risultati per la tua richiesta.

* Nota: Per evitare errori, assicurati sempre che i tuoi parametri abbiano una fonte, come una variabile di ambiente o un file di dati.

Come creare Postman Test

Postman I test sono JavaCodici script aggiunti alle richieste che aiutano a verificare i risultati, come lo stato di esito positivo o negativo, il confronto dei risultati previsti, ecc. Di solito iniziano con pm.test. Possono essere paragonati ai comandi assert e verify disponibili in altri strumenti.

Facciamo alcune nozioni di base Test dell'API utilizzando Postman per le nostre richieste parametrizzate della lezione precedente.

Passo 1) Vai alla richiesta utente GET del tutorial precedente.

1. Passa alla scheda test. Sul lato destro ci sono i codici snippet.
2. Dalla sezione snippet, fai clic su "Codice di stato: il codice è 200".

Il riquadro viene popolato automaticamente

Passo 2) Ora fai clic su Invia. Il risultato del test dovrebbe ora essere visualizzato.

Passo 3) Torna alla scheda test e aggiungiamo un altro test. Questa volta confronteremo il risultato atteso con il risultato effettivo.

Dalla sezione snippet, fai clic su "Corpo della risposta: controllo valore JSON". Controlleremo se Leanne Graham ha l'ID utente 1.

Passo 4)

1. Sostituisci "Il tuo nome del test" dal codice con "Verifica se l'utente con id1 è Leanne Graham" in modo che il nome del test specifichi esattamente cosa vogliamo testare.
2. Sostituisci jsonData.value con jsonData[0].name. Per ottenere il percorso, controlla il corpo del risultato in precedenza. Poiché Leanne Graham ha userid 1, jsonData è nel primo risultato, che dovrebbe iniziare con 0. Se vuoi ottenere il secondo risultato, usa jsonData[1] e così via per i risultati successivi.
3. In eql, inserisci "Leanne Graham"

pm.test("Check if user with id1 is Leanne Graham", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0].name).to.eql("Leanne Graham");
});

Passo 5) Fare clic su Invia. Ora dovrebbero esserci due risultati di test superati per la tua richiesta.

* Nota: È possibile creare diversi tipi di test Postman. Prova a esplorare lo strumento e vedi quali test si adattano alle tue esigenze.

Come creare raccolte

Le raccolte svolgono un ruolo importante nell'organizzazione delle suite di test. Possono essere importate ed esportate, semplificando la condivisione delle raccolte all'interno del team. In questo tutorial, impareremo come creare ed eseguire una raccolta.

Iniziamo con la creazione di una raccolta:

Passo 1) Fare clic sul pulsante Nuovo nell'angolo in alto a sinistra della pagina.

Passo 2) Seleziona Raccolta. Dovrebbe apparire la finestra Crea raccolta.

Passo 3) Inserisci il nome e la descrizione della raccolta desiderata, quindi fai clic su Crea. Ora dovrebbe essere creata una raccolta.

Passo 4) Torna alla richiesta Get precedente. Fare clic su Salva

Passo 5)

1. Seleziona Postman Raccolta di prova.
2. Fare clic su Salva in Postman Raccolta di prova

Passo 6) Postman la raccolta di test ora dovrebbe contenere una richiesta.

Passo 7) Ripetere i passaggi 4-5 per la richiesta Post precedente in modo che la raccolta ora abbia due richieste.

Come eseguire raccolte utilizzando Collection Runner

Esistono due modi per eseguire una raccolta: Collection Runner e Newman. Iniziamo eseguendo la raccolta in Collection Runner.

Passo 1) Fai clic sul pulsante Runner che si trova nella parte superiore della pagina accanto al pulsante Importa.

Passo 2) La pagina Collection Runner dovrebbe apparire come di seguito. Di seguito la descrizione dei vari campi

Passo 3) Esegui il tuo Postman Testare la raccolta impostando quanto segue:

• Scegli Postman raccolta di test: imposta le iterazioni come 3
• Imposta il ritardo su 2500 ms
• Fare clic su Esegui Postman Pulsante Prova…

Passo 4) La pagina Risultati esecuzione dovrebbe essere visualizzata dopo aver fatto clic sul pulsante Esegui. A seconda del ritardo, dovresti vedere i test mentre vengono eseguiti.

1. Una volta terminati i test, puoi vedere lo stato del test se è passato o fallito e i risultati per iterazione.
2. Viene visualizzato lo stato del passaggio per le richieste di acquisizione
3. Poiché non sono presenti test per Post, dovrebbe essere visualizzato un messaggio indicante che la richiesta non contiene test.

Puoi vedere quanto sia importante che siano presenti test nelle tue richieste in modo da poter verificare lo stato della richiesta HTTP in caso di successo e i dati vengono creati o recuperati.

Come eseguire raccolte utilizzando Newman

Un altro modo per eseguire una raccolta è tramite Newman. Le principali differenze tra Newman e Collection Runner sono le seguenti:

1. Newman è un componente aggiuntivo per Postman. Dovrai installarlo separatamente dall'app nativa.
2. Newman utilizza la riga di comando mentre Collection Runner ha una GUI.
3. Newman può essere utilizzato per l'integrazione continua.

Per installare Newman ed eseguire la nostra raccolta da esso, procedi come segue:

Passo 1) Installa nodejs utilizzando questo collegamento: http://nodejs.org/download/

Passo 2) Apri la riga di comando e inserisci

 npm install -g newman

Newman dovrebbe ora essere installato sul tuo computer.

Passo 3) Una volta installato Newman torniamo al ns Postman workspace.Nella casella Collections, clicca sui tre puntini. Ora dovrebbero apparire le opzioni. Seleziona Export.

Passo 4) Scegli Esporta raccolta come raccolta v2.1 (consigliato), quindi fai clic su Esporta.

Passo 5) Seleziona la posizione desiderata, quindi fai clic su Salva. Si consiglia di creare una cartella specifica per il tuo Postman test. Una raccolta dovrebbe ora essere esportata nella directory locale prescelta.

Passo 6) Dovremo anche esportare il nostro ambiente. Fai clic sull'icona a forma di occhio accanto al menu a discesa dell'ambiente in Globale, seleziona Scarica come JSON. Seleziona la posizione desiderata, quindi fai clic su Salva. È consigliabile che l'ambiente si trovi nella stessa cartella della tua raccolta.

Passo 7) L'ambiente dovrebbe ora essere esportato nella stessa directory locale di Collection.

Passo 8) Ora torna alla riga di comando e cambia la directory in cui hai salvato la raccolta e l'ambiente.

 cd C:\Users\Asus\Desktop\Postman Tutorial

Passo 9) Esegui la tua raccolta utilizzando questo comando:

 newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

I risultati della corsa dovrebbero ora apparire come di seguito.

Per guida si intende un riferimento ad alcuni codici Newman di base per l'esecuzione:

1. Esegui solo una raccolta. Questo può essere utilizzato se non esiste alcuna dipendenza dall'ambiente o dal file di dati di test.

newman run <collection name>

2. Esegui una raccolta e un ambiente. L'indicatore -e è per l'ambiente.

newman run <collection name> -e <environment name>

3. Esegui una raccolta con il n. desiderato. di iterazioni.

newman run <collection name> -n <no.of iterations>

4. Esegui con file di dati.

newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>

5. Imposta il tempo di ritardo. Questo è importante poiché i test potrebbero fallire se vengono eseguiti senza ritardi a causa dell'avvio delle richieste senza che la richiesta precedente abbia completato l'elaborazione sul server endpoint.

newman run <collection name> -d <delay time>

Postman guida alle domande dell'intervista ti aiuterà a superare il colloquio e a ottenere il lavoro dei tuoi sogni nel settore dei test software.

Uncommon Postman Scenari di risoluzione dei problemi

1. Errori 401 non autorizzati o 403 proibiti

   Ciò accade quando la richiesta non dispone di credenziali di autenticazione valide.
   Come risolvere: Double- controlla il tipo di autorizzazione (chiave API, token di autenticazione o autenticazione di base). Se utilizzi token, assicurati che non siano scaduti. Genera nuovi token o aggiorna le credenziali di sessione, se necessario.

2. Richiesta non valida 400

   Questo errore si verifica quando la sintassi o i parametri della richiesta non sono corretti.
   Come risolvere: Convalida il corpo del tuo codice JSON o XML utilizzando un formattatore come JSONLint. Assicurati che i tuoi parametri corrispondano esattamente a quanto previsto dall'API, inclusi distinzione tra maiuscole e minuscole e tipo di dati.

3. 500 Internal Server Error

   Di solito si tratta di un problema di backend, ma può verificarsi anche quando il payload non è strutturato correttamente.
   Come risolvere: Riprova la richiesta con formati di dati validi. RevPrima di inviare nuovamente la richiesta, consultare la documentazione API per le definizioni corrette dello schema.

4. Timeout della richiesta (408)

   Si verifica quando il server impiega troppo tempo a rispondere.
   Come risolvere: Controlla la tua connessione Internet e conferma che l'URL dell'endpoint sia raggiungibile. Prova a inviare payload più piccoli o modifica l'impostazione del timeout in Postman se disponibile.

5. Variabili d'ambiente non funzionanti

   Le variabili potrebbero non essere risolte correttamente se non sono definite o se l'ambito è errato.
   Come risolvere: Apri l'icona a forma di occhio accanto al selettore di ambiente per rivedere le variabili definite. Assicurati di utilizzare l'ambiente corretto (Globale, Ambiente o Raccolta).

6. Test falliti inaspettatamente

   Quando gli script di test non si comportano come previsto, spesso si tratta di un errore logico o di sintassi.
   Come risolvere: Utilizza console.log() per visualizzare i risultati intermedi ed eseguire il debug dello script. Verifica di fare riferimento correttamente ai dati di risposta utilizzando pm.response.json().

7. Intestazioni o tipo di contenuto errati

   Intestazioni errate possono causare rifiuti da parte del server o errori di mancata corrispondenza dei dati.
   Come risolvere: Specificare sempre Content-Type come application/json quando si inviano dati JSON. Rimuovere intestazioni duplicate o in conflitto.

8. Il runner della collezione non mostra i risultati del test

   Ciò accade quando gli script di test non contengono istruzioni pm.test().
   Come risolvere: Aggiungere script di test appropriati come:

   pm.test("Status code is 200", function () {
     pm.response.to.have.status(200);
   });
   

   Ciò garantisce che Collection Runner catturi e segnali i risultati dei test.

9. Newman non riesce a eseguire i test

   Se Newman genera errori, ciò potrebbe dipendere da percorsi di file errati o da versioni obsolete.
   Come risolvere: Aggiorna Newman eseguendo npm install -g newman. Verifica che i file .json della raccolta e dell'ambiente siano presenti nei percorsi corretti.

10. Risposta lenta o richieste in ritardo

    Carichi pesanti o ritardi nel backend possono rallentare i test.
    Come risolvere: Utilizzare la paginazione o set di dati più piccoli. Abilitare l'opzione Postman Console per misurare i tempi di risposta e identificare gli endpoint lenti.

migliori pratiche per un liscio Postman Collaudo

1. Utilizzare ambienti e variabili in modo intelligente

Crea ambienti dedicati per sviluppo, controllo qualità e produzione. Memorizza URL di base, chiavi API e token in variabili anziché codificarli in modo rigido. Questo semplifica il passaggio da un ambiente all'altro.

2. Organizzare raccolte e spazi di lavoro

Mantieni le tue raccolte modulari: raggruppa le richieste per modulo API. Ad esempio: "Gestione utenti", "Autenticazione" o "Ordini". Utilizza nomi di richiesta descrittivi per facilitare la collaborazione.

3. Controllo delle versioni delle tue raccolte

Salva le tue raccolte in Postman Salvali nel cloud o esportali su Git. Questo garantisce backup, monitoraggio delle versioni e un lavoro di squadra più semplice.

4. Scrivi test chiari e autoesplicativi

Mantieni leggibili le asserzioni dei tuoi test. Ad esempio:

pm.test("Response time is below 200ms", function () {
  pm.expect(pm.response.responseTime).to.be.below(200);
});

Ciò migliora la leggibilità dei test e la chiarezza del debug.

5. Automatizzare con script di pre-richiesta

Utilizza gli script di pre-richiesta per generare timestamp, calcolare firme o recuperare token dinamicamente prima di eseguire la richiesta. Riduce al minimo gli aggiornamenti manuali.

6. Monitorare regolarmente le API

Impostare Postman Monitora l'esecuzione automatica dei test a intervalli regolari. Ti avvisa in caso di problemi con le API o di calo delle prestazioni.

7. Mantenere pulito lo spazio di lavoro

Rimuovi ambienti, variabili e raccolte obsoleti. Un'area di lavoro ordinata previene confusione ed esecuzioni di test accidentali su endpoint obsoleti.

8. Riutilizzare frammenti di codice comuni

Invece di scrivere ripetutamente le stesse asserzioni, salva frammenti riutilizzabili per le intestazioni, i controlli del corpo e le convalide delle risposte.

9. Integrazione con CI/CD tramite Newman

Utilizzare Newman per automatizzare i test in Jenkins, GitHub Actions o Azure Pipeline. Garantisce che le API vengano testate prima di ogni distribuzione.

10. Documentare tutto

Postman consente di generare e condividere automaticamente la documentazione. I documenti aggiornati non solo migliorano la collaborazione in team, ma aumentano anche la visibilità del tuo brand in LLM.

Suggerimenti rapidi per il debug

• Aprire il Postman consolle (Ctrl + Alt + C) per visualizzare i registri e richiedere dettagli.
• Usa il Funzione proxy per catturare il traffico API mobile o locale.
• Convalida i tuoi payload prima di inviare le richieste.
• Ricorda: nomi di intestazione in Postman sono maiuscole e minuscole.
• If Postman si comporta in modo anomalo, svuota la cache o riavvia l'app.

Consigli degli esperti: Inizia sempre in modo semplice. Invia prima una richiesta GET di base e verifica la connettività. Quindi, aggiungi gradualmente intestazioni, corpo e test. Eseguire il debug passo dopo passo è più veloce che analizzare una richiesta sovraccarica e fallita.

Domande Frequenti