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.
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:
- Primo terminale:
fastapi dev api/deposito.py. Lascialo acceso: è il tuo server. - Secondo terminale: scrivi il comando nel file, provalo con
bash palestra/<nome>.sh, poi lancia il test conpytest 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.
| # | Richiesta | Cosa impari | Difficoltà |
|---|---|---|---|
| 1 | Tutti i treni | -i: il codice e gli header | ★ |
| 2 | I treni che dormono | la query, e lo spazio che diventa %20 | ★ |
| 3 | Un treno nuovo | -X, -H, -d, e il 201 | ★★ |
| 4 | Un treno cambia posto | una PUT con il corpo intero | ★★ |
| 5 | Un treno va in demolizione | DELETE e il 204 senza corpo | ★★ |
| 6 | Chi sono | il 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
HTTP/1.1 200 OK e gli header?Aiutino 2
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 spazioCome provi: bash palestra/treni_in_deposito.sh, poi pytest palestra/test_treni_in_deposito.py -v.
Aiutino 1
?nome=valore.Aiutino 2
stato. Nel valore, lo spazio non può restare uno spazio.Aiutino 3
%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
POST (-X POST), un corpo (-d) e l'indirizzo "$BASE_URL/treni".Aiutino 2
Aiutino 3
-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
"$BASE_URL/treni/M20".Aiutino 2
Aiutino 3
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
DELETE.Aiutino 2
-H: il treno è nell'indirizzo, "$BASE_URL/treni/M16".Aiutino 3
-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
POST a /login con un corpo JSON (badge e password) e l'header Content-Type. Nella risposta cerca access_token.Aiutino 2
/me basta una GET con un header in più: -H "Authorization: …".Aiutino 3
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 fai | Cosa vedi |
|---|---|---|
| 1 | GET {{baseUrl}}/treni | 200 OK, otto treni nel Body |
| 2 | GET {{baseUrl}}/treni, scheda Params: chiave stato, valore in deposito | Postman aggiunge la query all'indirizzo (e pensa lui allo spazio); due treni, M10 e M20 |
| 3 | POST {{baseUrl}}/treni, Body → raw → JSON, il corpo del M22 | 201 Created. Un secondo Send: 409 Conflict |
| 4 | PUT {{baseUrl}}/treni/M20, Body raw JSON con i quattro campi | 200 OK, e il M20 è in servizio a Via Variabile |
| 5 | DELETE {{baseUrl}}/treni/M16 | 204 No Content, Body vuoto. Un secondo Send: 404 Not Found |
| 6 | POST {{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).