Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Il banco di lavoro6. Postman e curlp. 143

Postman e curl, la palestra

Sei richieste da costruire, con i test

  • 60–90 minuti di lavoro

Sei richieste da costruire con curl, dal ★ al ★★★, tutte contro l'API del deposito della Linea Menta, che è nello zip. Ogni richiesta è un file .sh con in alto la storia e le istruzioni: sotto scrivi un comando curl. Il suo test lo lancia contro un server tutto suo, e guarda il risultato.

Gli esercizi da scaricare

Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.

banco-postman-e-curl.zip18 KB

Prima di iniziare

Scompatta lo zip e segui il README.md che c'è dentro: venv, pip install. Se è la prima volta, la pagina Come si usa un esercizio lo fa con te, un comando alla volta.

Servono due terminali, tutti e due nella cartella dello zip:

  1. Primo terminale: fastapi dev api/deposito.py. Lascialo acceso: è il tuo server.
  2. Secondo terminale: scrivi il comando nel file, provalo con bash palestra/<nome>.sh, poi lancia il test con pytest palestra/test_<nome>.py -v.

I test non usano il tuo server: ne accendono uno loro, su un'altra porta. Per questo nel comando scrivi "$BASE_URL/percorso" e non l'indirizzo per intero: se scrivi http://127.0.0.1:8000/… il test si ferma e te lo dice.

#RichiestaCosa impariDifficoltà
1Tutti i treni-i: il codice e gli header★
2I treni che dormonola query, e lo spazio che diventa %20★
3Un treno nuovo-X, -H, -d, e il 201★★
4Un treno cambia postouna PUT con il corpo intero★★
5Un treno va in demolizioneDELETE e il 204 senza corpo★★
6Chi sonoil login e Authorization: Bearer★★★

1 · Tutti i treni ★

palestra/tutti_i_treni.sh

Ernesto Pozzi, il capo deposito, vuole la risposta intera della centrale: la riga del codice, gli header e il corpo.

Come provi: bash palestra/tutti_i_treni.sh, poi pytest palestra/test_tutti_i_treni.py -v.

Aiutino 1
Quale opzione di curl mostra anche la riga HTTP/1.1 200 OK e gli header?
Aiutino 2
Il comando è corto: curl, l'opzione, e l'indirizzo "$BASE_URL/treni" tra virgolette doppie.

2 · I treni che dormono ★

palestra/treni_in_deposito.sh

Lucia Ferri vuole solo i treni con stato in deposito.

GET /treni?stato=in deposito       ← così non va: lo spazio

Come provi: bash palestra/treni_in_deposito.sh, poi pytest palestra/test_treni_in_deposito.py -v.

Aiutino 1
Un filtro si scrive dopo un punto di domanda: ?nome=valore.
Aiutino 2
Il filtro si chiama stato. Nel valore, lo spazio non può restare uno spazio.
Aiutino 3
Lo spazio si scrive %20: stato=in%20deposito. E tutto l'indirizzo tra virgolette doppie.

3 · Un treno nuovo ★★

palestra/nuovo_treno.sh

Arriva il M22, una metro da 4 vagoni. La centrale deve rispondere 201 Created, e il treno deve esserci anche dopo.

Come provi: bash palestra/nuovo_treno.sh (una volta sola: poi il tuo server ha già il M22 e risponde 409), poi pytest palestra/test_nuovo_treno.py -v.

Aiutino 1
Serve il verbo POST (-X POST), un corpo (-d) e l'indirizzo "$BASE_URL/treni".
Aiutino 2
Il corpo è il JSON del treno: codice, tipo e vagoni. Tra virgolette semplici, perché dentro ci sono le doppie.
Aiutino 3
Con -d serve anche un header che dica alla centrale che il corpo è JSON: -H "Content-Type: application/json". E -i per vedere il 201.

4 · Un treno cambia posto ★★

palestra/sposta_treno.sh

Il M20 esce dal deposito: da adesso è in servizio a Via Variabile. Una PUT sostituisce il treno intero: il corpo ha tutti i campi (tipo, vagoni, stato, stazione), il codice sta già nell'indirizzo.

Come provi: bash palestra/sposta_treno.sh, poi pytest palestra/test_sposta_treno.py -v.

Aiutino 1
È lo stesso schema della richiesta 3, ma il verbo è un altro e l'indirizzo comprende il codice: "$BASE_URL/treni/M20".
Aiutino 2
Il M20 è una metro da 4 vagoni: quei due campi non cambiano, ma vanno scritti lo stesso.
Aiutino 3
Se nel corpo mandi solo stazione, la centrale risponde 422 e ti dice quali campi mancano: leggi la risposta con -i.

5 · Un treno va in demolizione ★★

palestra/togli_treno.sh

Ivo toglie il M16 dalla centrale. La centrale risponde 204 No Content: successo, senza corpo.

Come provi: bash palestra/togli_treno.sh. Rilanciandolo, il M16 non c'è più: 404, ed è giusto. Poi pytest palestra/test_togli_treno.py -v.

Aiutino 1
Il verbo che toglie si chiama DELETE.
Aiutino 2
Niente corpo e niente -H: il treno è nell'indirizzo, "$BASE_URL/treni/M16".
Aiutino 3
Senza -i un 204 non stampa niente: aggiungilo per vedere la riga del codice.

6 · Chi sono ★★★

palestra/chi_sono.sh

Fai il login come Ernesto Pozzi (badge B-09, password menta-ernesto), copia il biglietto nella riga BIGLIETTO del file e chiedi a /me chi sei. La risposta deve essere la scheda di Ernesto.

Come provi: prima il login a mano (come nell'esempio E degli esercizi spiegati), poi bash palestra/chi_sono.sh, poi pytest palestra/test_chi_sono.py -v. Il test fa il login da solo e mette il suo biglietto in BIGLIETTO: nel comando scrivi $BIGLIETTO, mai il biglietto per esteso.

Aiutino 1
Il login è una POST a /login con un corpo JSON (badge e password) e l'header Content-Type. Nella risposta cerca access_token.
Aiutino 2
Per /me basta una GET con un header in più: -H "Authorization: …".
Aiutino 3
Dopo i due punti, prima il biglietto, scrivi la parola Bearer e uno spazio: -H "Authorization: Bearer $BIGLIETTO". Il comando è tra virgolette doppie, così la shell mette il biglietto al posto di $BIGLIETTO.

Le stesse sei, in Postman

Non c'è un test per Postman: il controllo sei tu, e il server risponde. Dopo la palestra con curl, rifai le richieste in una collezione («Deposito Linea Menta», con la variabile baseUrl = http://127.0.0.1:8000), come negli esercizi spiegati (esempio F). Per ognuna: cosa fai, cosa devi vedere.

#Cosa faiCosa vedi
1GET {{baseUrl}}/treni200 OK, otto treni nel Body
2GET {{baseUrl}}/treni, scheda Params: chiave stato, valore in depositoPostman aggiunge la query all'indirizzo (e pensa lui allo spazio); due treni, M10 e M20
3POST {{baseUrl}}/treni, Body → raw → JSON, il corpo del M22201 Created. Un secondo Send: 409 Conflict
4PUT {{baseUrl}}/treni/M20, Body raw JSON con i quattro campi200 OK, e il M20 è in servizio a Via Variabile
5DELETE {{baseUrl}}/treni/M16204 No Content, Body vuoto. Un secondo Send: 404 Not Found
6POST {{baseUrl}}/login con lo script post-response; poi GET {{baseUrl}}/me con Bearer Token {{biglietto}}200 e i dati di Ernesto Pozzi. Senza il Token: 401 Unauthorized

Se Postman dà Could not send request, il server è spento (o stai usando Postman nel browser, e serve l'app).