Come testare un'API con Postman: guida pratica passo dopo passo

Come testare un'API con Postman: guida pratica passo passo

Introduzione

Postman è uno degli strumenti più utilizzati per testare API REST in modo semplice e intuitivo. Permette di inviare richieste HTTP, analizzare le risposte e simulare il comportamento di un’applicazione client.

È uno strumento fondamentale per sviluppatori backend, frontend e tester che lavorano con servizi web e integrazioni API.

Cos’è Postman

Postman è un’applicazione che consente di costruire e inviare richieste HTTP senza scrivere codice. Supporta tutti i principali metodi: GET, POST, PUT, DELETE.

Installazione e avvio

Postman può essere utilizzato come applicazione desktop o versione web. Dopo l’installazione è possibile creare una nuova richiesta selezionando il tipo di metodo HTTP.

Creare una richiesta API

Per testare un’API in Postman è sufficiente:

aprire Postman
creare una nuova request
inserire l’URL dell’endpoint
selezionare il metodo HTTP
inviare la richiesta

Esempio di richiesta GET

GET https://api.esempio.com/clienti
Accept: application/json

Questa richiesta recupera una lista di clienti dal server.

Esempio di richiesta POST

Le richieste POST vengono utilizzate per inviare dati al server.

POST https://api.esempio.com/clienti
Content-Type: application/json

{
  "nome": "Mario",
  "cognome": "Rossi"
}

Gestione delle risposte

Postman mostra la risposta del server in formato leggibile, includendo:

status code HTTP
body della risposta
headers
tempo di risposta

Autenticazione nelle API

Molte API richiedono autenticazione tramite API Key, Bearer Token o OAuth. Postman permette di configurare facilmente questi metodi nella sezione Authorization.

GET https://api.esempio.com/profilo
Authorization: Bearer TOKEN_DI_ACCESSO

Uso delle Collection

Le Collection di Postman permettono di organizzare più richieste API in gruppi logici. Questo è utile per testare interi sistemi o microservizi.

Variabili e ambienti

Postman consente di utilizzare variabili di ambiente per gestire URL e token in modo dinamico.

Questo semplifica il passaggio tra ambienti di sviluppo, test e produzione.

Test automatici

Postman supporta anche script di test per verificare automaticamente le risposte delle API.

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

Conclusione

Postman è uno strumento essenziale per chi lavora con le API. Permette di testare, debug e documentare servizi web in modo rapido e intuitivo.