Verbi e codici, esercizi spiegati
Cinque giri su InfoMenta, una richiesta alla volta
- 25 minuti di lettura
Cinque esempi, dal più semplice. Ognuno ha lo stesso ritmo:
- Prevedi: leggi le richieste e scrivi su un foglio che codice risponde InfoMenta a ognuna. Prima di aprire la risposta.
- In italiano: cosa succede, a parole.
- Passo per passo: una richiesta alla volta, con il suo codice.
- Cosa portiamo a casa: la cosa da ricordare.
Per provarli dal vivo
InfoMenta è dentro lo zip della palestra. Dopo averlo preparato come dice il suo README.md, ti servono due terminali.
Nel primo terminale (il server):
cd ~/corso/http-verbi-e-codici
source .venv/bin/activate
fastapi dev palestra/infomenta.pyNel secondo terminale lanci i comandi curl degli esempi, uno alla volta. Il server, intanto, scrive una riga per ogni richiesta che riceve: verbo, percorso e codice.
A · Un treno nasce e muore
Ernesto Pozzi prova tutto il giro di un treno nuovo, l'M20, prima di metterlo in servizio. Quattro richieste, una dopo l'altra:
curl -i -X POST http://127.0.0.1:8000/treni \
-H "Content-Type: application/json" \
-d '{"codice": "M20", "tipo": "metro", "vagoni": 6, "stazione_id": 3}'
curl -i http://127.0.0.1:8000/treni/7
curl -i -X DELETE http://127.0.0.1:8000/treni/7
curl -i http://127.0.0.1:8000/treni/7Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Nel terminale del server compare:
INFO: 127.0.0.1:59814 - "POST /treni HTTP/1.1" 201 Created
INFO: 127.0.0.1:59815 - "GET /treni/7 HTTP/1.1" 200 OK
INFO: 127.0.0.1:59816 - "DELETE /treni/7 HTTP/1.1" 204 No Content
INFO: 127.0.0.1:59817 - "GET /treni/7 HTTP/1.1" 404 Not FoundQuattro codici: 201, 200, 204, 404.
In italiano.
- La POST crea il treno. L'id lo sceglie InfoMenta: il più grande che c'è, più uno. I treni vanno da 1 a 6, quindi l'M20 diventa il 7. Risponde 201 e il treno, con l'id.
- La GET legge il treno 7: c'è. Risponde 200.
- La DELETE lo toglie. Risponde 204: fatto, e non c'è niente da mostrare.
- La stessa GET di prima: il treno 7 non c'è più. Risponde 404.
La risposta della POST, intera:
HTTP/1.1 201 Created
date: Thu, 19 Nov 2026 15:59:48 GMT
server: uvicorn
content-length: 79
content-type: application/json
{"codice":"M20","tipo":"metro","vagoni":6,"stazione_id":3,"guasto":null,"id":7}E quella della DELETE: dopo gli header, niente.
HTTP/1.1 204 No Content
date: Thu, 19 Nov 2026 15:59:48 GMT
server: uvicorn
content-type: application/json
Passo per passo.
| Richiesta | Codice | I treni di InfoMenta, dopo |
|---|---|---|
| prima | — | da 1 a 6 |
POST /treni | 201 | da 1 a 6, più il 7 (M20) |
GET /treni/7 | 200 | uguali: una GET non cambia niente |
DELETE /treni/7 | 204 | da 1 a 6 |
GET /treni/7 | 404 | da 1 a 6 |
Cosa portiamo a casa. La stessa richiesta, GET /treni/7, ha avuto due codici diversi: 200 la prima volta, 404 la seconda. Il codice non dipende solo da cosa chiedi, ma da cosa c'è nel server in quel momento.
B · Sostituire o ritoccare
Al treno M16 (il treno 3) tolgono un vagone: da 6 a 5. Ernesto prova tre richieste.
curl -i -X PATCH http://127.0.0.1:8000/treni/3 \
-H "Content-Type: application/json" \
-d '{"vagoni": 5}'
curl -i -X PUT http://127.0.0.1:8000/treni/3 \
-H "Content-Type: application/json" \
-d '{"vagoni": 5}'
curl -i -X PUT http://127.0.0.1:8000/treni/3 \
-H "Content-Type: application/json" \
-d '{"codice": "M16", "tipo": "metro", "vagoni": 5, "stazione_id": 5}'Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Nel terminale del server compare:
INFO: 127.0.0.1:59971 - "PATCH /treni/3 HTTP/1.1" 200 OK
INFO: 127.0.0.1:59972 - "PUT /treni/3 HTTP/1.1" 422 Unprocessable Entity
INFO: 127.0.0.1:59973 - "PUT /treni/3 HTTP/1.1" 200 OK200, 422, 200. Lo stesso corpo, {"vagoni": 5}, va bene con la PATCH e non va bene con la PUT.
In italiano.
- La PATCH ritocca: cambia solo i campi che le mandi. Il treno 3 ha 5 vagoni, il resto è com'era. 200.
- La PUT sostituisce: vuole il treno intero. Le arriva solo
vagoni: mancano tre campi, e InfoMenta non li inventa. 422. - La stessa PUT, con tutti i campi: questa volta va. 200.
La risposta della PUT con il campo solo:
HTTP/1.1 422 Unprocessable Entity
date: Thu, 19 Nov 2026 16:02:05 GMT
server: uvicorn
content-length: 276
content-type: application/json
{"detail":[{"type":"missing","loc":["body","codice"],"msg":"Field required","input":{"vagoni":5}},{"type":"missing","loc":["body","tipo"],"msg":"Field required","input":{"vagoni":5}},{"type":"missing","loc":["body","stazione_id"],"msg":"Field required","input":{"vagoni":5}}]}Passo per passo. Il detail del 422 è una lista: un errore per ogni campo che non va. In ogni errore, loc dice dove (body, il corpo, e il nome del campo) e msg dice cosa.
loc | msg | In italiano |
|---|---|---|
["body","codice"] | Field required | Nel corpo manca codice |
["body","tipo"] | Field required | Nel corpo manca tipo |
["body","stazione_id"] | Field required | Nel corpo manca stazione_id |
vagoni non c'è nella lista: l'hai mandato. E nemmeno guasto: in InfoMenta è facoltativo, se manca vale null.
Cosa portiamo a casa. PUT: si manda tutto, anche quello che non cambia. PATCH: si manda solo quello che cambia. Con la PUT, un campo che manca è un 422, e InfoMenta non tocca il treno.
C · Due volte la stessa richiesta
Ernesto ha il dito pesante: ogni richiesta la manda due volte. Quattro coppie, e in fondo un treno nuovo con un codice che c'è già.
curl -i http://127.0.0.1:8000/treni/1
curl -i http://127.0.0.1:8000/treni/1
curl -i -X POST http://127.0.0.1:8000/annunci \
-H "Content-Type: application/json" \
-d '{"testo": "Porta Codice: binario 2 chiuso per pulizie"}'
curl -i -X POST http://127.0.0.1:8000/annunci \
-H "Content-Type: application/json" \
-d '{"testo": "Porta Codice: binario 2 chiuso per pulizie"}'
curl -i -X PUT http://127.0.0.1:8000/treni/4 \
-H "Content-Type: application/json" \
-d '{"codice": "T05", "tipo": "tram", "vagoni": 2, "stazione_id": 2}'
curl -i -X PUT http://127.0.0.1:8000/treni/4 \
-H "Content-Type: application/json" \
-d '{"codice": "T05", "tipo": "tram", "vagoni": 2, "stazione_id": 2}'
curl -i -X DELETE http://127.0.0.1:8000/treni/6
curl -i -X DELETE http://127.0.0.1:8000/treni/6
curl -i -X POST http://127.0.0.1:8000/treni \
-H "Content-Type: application/json" \
-d '{"codice": "M12", "tipo": "metro", "vagoni": 4, "stazione_id": 2}'Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Nel terminale del server compare:
INFO: 127.0.0.1:59976 - "GET /treni/1 HTTP/1.1" 200 OK
INFO: 127.0.0.1:59977 - "GET /treni/1 HTTP/1.1" 200 OK
INFO: 127.0.0.1:59978 - "POST /annunci HTTP/1.1" 201 Created
INFO: 127.0.0.1:59979 - "POST /annunci HTTP/1.1" 201 Created
INFO: 127.0.0.1:59980 - "PUT /treni/4 HTTP/1.1" 200 OK
INFO: 127.0.0.1:59981 - "PUT /treni/4 HTTP/1.1" 200 OK
INFO: 127.0.0.1:59982 - "DELETE /treni/6 HTTP/1.1" 204 No Content
INFO: 127.0.0.1:59983 - "DELETE /treni/6 HTTP/1.1" 404 Not Found
INFO: 127.0.0.1:59984 - "POST /treni HTTP/1.1" 409 ConflictI codici delle due POST sono uguali, ma i corpi no: guarda l'id.
{"testo":"Porta Codice: binario 2 chiuso per pulizie","id":1}{"testo":"Porta Codice: binario 2 chiuso per pulizie","id":2}In italiano.
- Due GET: InfoMenta legge due volte lo stesso treno. Niente cambia.
- Due POST: ogni POST crea una cosa nuova. Adesso gli annunci sono due, uguali, con l'id 1 e l'id 2.
- Due PUT: la seconda sostituisce il tram 4 con lo stesso tram 4. Il risultato è uguale a dopo la prima.
- Due DELETE: la prima toglie il treno 6; la seconda non trova più niente da togliere: 404.
- Un treno nuovo con il codice M12, che è già del treno 1: InfoMenta non crea un doppione. 409, Conflict.
HTTP/1.1 409 Conflict
date: Thu, 19 Nov 2026 16:02:07 GMT
server: uvicorn
content-length: 48
content-type: application/json
{"detail":"Codice già usato da un altro treno"}Passo per passo.
| Verbo | La prima volta | La seconda volta | Perché |
|---|---|---|---|
| GET | 200 | 200, stesso corpo | Leggere non cambia niente |
| POST | 201, id 1 | 201, id 2 | Ogni POST crea una cosa in più |
| PUT | 200 | 200, stesso corpo | Sostituire con la stessa cosa dà la stessa cosa |
| DELETE | 204 | 404 | La seconda volta non c'è più niente da togliere |
Cosa portiamo a casa. GET, PUT e DELETE, mandate due volte, lasciano i dati come una volta sola. La POST no: due volte, due cose. Per questo, quando ricarichi la pagina dopo aver mandato un modulo, il browser ti chiede se vuoi inviarlo di nuovo.
D · Chi sei? Cosa puoi fare?
Nadia Russo, la guardia giurata, controlla chi riesce a leggere il registro del deposito. Il badge si manda nell'header Authorization, dopo la parola Bearer. Prova con tre badge: quello di Ernesto (B-12, il capo deposito), uno inventato (B-99), e quello di Lucia Ferri (B-01, capotreno).
curl -i http://127.0.0.1:8000/deposito/registro -H "Authorization: Bearer B-12"
curl -i http://127.0.0.1:8000/deposito/registro -H "Authorization: Bearer B-99"
curl -i http://127.0.0.1:8000/deposito/registro -H "Authorization: Bearer B-01"Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Nel terminale del server compare:
INFO: 127.0.0.1:59839 - "GET /deposito/registro HTTP/1.1" 200 OK
INFO: 127.0.0.1:59840 - "GET /deposito/registro HTTP/1.1" 401 Unauthorized
INFO: 127.0.0.1:59841 - "GET /deposito/registro HTTP/1.1" 403 Forbidden200, 401, 403.
In italiano.
- B-12 è il badge del capo deposito: il registro è suo. 200, e il registro della notte.
- B-99 non è di nessuno: InfoMenta non sa chi sei. 401.
- B-01 è un badge vero: InfoMenta sa che sei Lucia Ferri. Ma il registro non è per una capotreno. 403.
Il disegno.
Le due risposte che dicono no:
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 16:00:07 GMT
server: uvicorn
www-authenticate: Bearer
content-length: 30
content-type: application/json
{"detail":"Badge sconosciuto"}HTTP/1.1 403 Forbidden
date: Thu, 19 Nov 2026 16:00:07 GMT
server: uvicorn
content-length: 79
content-type: application/json
{"detail":"Lucia Ferri, il registro del deposito è solo per il capo deposito"}Il 401 ha un header in più, www-authenticate: Bearer: è il server che dice «mandami un badge, in questo modo». Il 403 non lo chiede, perché il badge l'ha già, e non basta: nel detail c'è perfino il nome di Lucia.
Passo per passo.
| Badge | InfoMenta sa chi sei? | Puoi leggere il registro? | Codice |
|---|---|---|---|
| B-12 | Sì, Ernesto Pozzi | Sì | 200 |
| B-99 | No | — | 401 |
| B-01 | Sì, Lucia Ferri | No | 403 |
Cosa portiamo a casa. Prima domanda: «chi sei?». Se la risposta è «non lo so», è un 401. Se la risposta c'è, seconda domanda: «puoi?». Se no, è un 403. Il login vero, con le password, è nel libro Login e sicurezza.
E · Di chi è la colpa?
Rosa Bellini prepara i viaggi per i clienti della sua agenzia. Non tutte le sue richieste sono scritte bene.
curl -i "http://127.0.0.1:8000/viaggio?da=1&a=5"
curl -i "http://127.0.0.1:8000/viaggio?da=1&a=9"
curl -i "http://127.0.0.1:8000/viaggio?da=1"
curl -i http://127.0.0.1:8000/stazioni/abc
curl -i -X DELETE http://127.0.0.1:8000/stazioni/1Per aiutarti: il viaggio vuole due numeri di stazione, da e a; le stazioni vanno da 1 a 6; le stazioni di InfoMenta si possono solo leggere.
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Nel terminale del server compare:
INFO: 127.0.0.1:59844 - "GET /viaggio?da=1&a=5 HTTP/1.1" 200 OK
INFO: 127.0.0.1:59845 - "GET /viaggio?da=1&a=9 HTTP/1.1" 404 Not Found
INFO: 127.0.0.1:59846 - "GET /viaggio?da=1 HTTP/1.1" 422 Unprocessable Entity
INFO: 127.0.0.1:59847 - "GET /stazioni/abc HTTP/1.1" 422 Unprocessable Entity
INFO: 127.0.0.1:59848 - "DELETE /stazioni/1 HTTP/1.1" 405 Method Not Allowed200, poi quattro codici che cominciano per 4: 404, 422, 422, 405.
In italiano.
- Da Porta Codice a Piazza Query: tutto giusto. 200, e il viaggio.
- La stazione 9 non c'è. La richiesta è scritta bene, ma chiede una cosa che non esiste: 404.
- Manca
a. Il viaggio vuole due numeri, e FastAPI lo sa: risponde 422 da solo, prima di entrare nella funzione che calcola il viaggio. abcal posto di un numero di stazione: anche questo lo vede FastAPI da solo. 422, non 404: la stazioneabcnon la cerca neanche.- Il percorso
/stazioni/1esiste, ma solo con GET. Con DELETE: 405.
Il disegno.
Tre delle quattro risposte con il 4, intere:
HTTP/1.1 422 Unprocessable Entity
date: Thu, 19 Nov 2026 16:00:09 GMT
server: uvicorn
content-length: 87
content-type: application/json
{"detail":[{"type":"missing","loc":["query","a"],"msg":"Field required","input":null}]}HTTP/1.1 422 Unprocessable Entity
date: Thu, 19 Nov 2026 16:00:09 GMT
server: uvicorn
content-length: 156
content-type: application/json
{"detail":[{"type":"int_parsing","loc":["path","stazione_id"],"msg":"Input should be a valid integer, unable to parse string as an integer","input":"abc"}]}HTTP/1.1 405 Method Not Allowed
date: Thu, 19 Nov 2026 16:00:09 GMT
server: uvicorn
allow: GET
content-length: 31
content-type: application/json
{"detail":"Method Not Allowed"}Il loc dei due 422 dice dove sta il problema: query (dopo il ?) per il primo, path (nel percorso) per il secondo. Il 405 porta l'header allow: GET: ecco i verbi che quel percorso accetta.
Passo per passo.
| Richiesta | Codice | Chi dice no | Cosa non va |
|---|---|---|---|
GET /viaggio?da=1&a=5 | 200 | nessuno | niente |
GET /viaggio?da=1&a=9 | 404 | la funzione di InfoMenta | la cosa chiesta non esiste |
GET /viaggio?da=1 | 422 | FastAPI, da solo | i dati: ne manca uno |
GET /stazioni/abc | 422 | FastAPI, da solo | i dati: non è un numero |
DELETE /stazioni/1 | 405 | FastAPI, da solo | il verbo |
Cosa portiamo a casa. «4xx, colpa tua» è solo l'inizio: la seconda e la terza cifra dicono cosa hai sbagliato. 404 la cosa, 422 i dati, 405 il verbo. Il 400, quello per una domanda che non ha senso, lo trovi nella palestra.
Pronto? Nella palestra ti aspettano dodici richieste a InfoMenta: per ognuna, prevedi il codice.