Vai al contenuto
code-to-code

Apro l'indice…

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

HTTP e API2. Verbi e codicip. 32

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:

  1. Prevedi: leggi le richieste e scrivi su un foglio che codice risponde InfoMenta a ognuna. Prima di aprire la risposta.
  2. In italiano: cosa succede, a parole.
  3. Passo per passo: una richiesta alla volta, con il suo codice.
  4. 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):

Terminale
cd ~/corso/http-verbi-e-codici
source .venv/bin/activate
fastapi dev palestra/infomenta.py

Nel 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:

Terminale
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/7
Prevedi 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 Found

Quattro codici: 201, 200, 204, 404.

In italiano.

  1. 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.
  2. La GET legge il treno 7: c'è. Risponde 200.
  3. La DELETE lo toglie. Risponde 204: fatto, e non c'è niente da mostrare.
  4. 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.

RichiestaCodiceI treni di InfoMenta, dopo
prima—da 1 a 6
POST /treni201da 1 a 6, più il 7 (M20)
GET /treni/7200uguali: una GET non cambia niente
DELETE /treni/7204da 1 a 6
GET /treni/7404da 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.

Terminale
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 OK

200, 422, 200. Lo stesso corpo, {"vagoni": 5}, va bene con la PATCH e non va bene con la PUT.

In italiano.

  1. La PATCH ritocca: cambia solo i campi che le mandi. Il treno 3 ha 5 vagoni, il resto è com'era. 200.
  2. La PUT sostituisce: vuole il treno intero. Le arriva solo vagoni: mancano tre campi, e InfoMenta non li inventa. 422.
  3. 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.

locmsgIn italiano
["body","codice"]Field requiredNel corpo manca codice
["body","tipo"]Field requiredNel corpo manca tipo
["body","stazione_id"]Field requiredNel 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à.

Terminale
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 Conflict

I 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.

  1. Due GET: InfoMenta legge due volte lo stesso treno. Niente cambia.
  2. Due POST: ogni POST crea una cosa nuova. Adesso gli annunci sono due, uguali, con l'id 1 e l'id 2.
  3. Due PUT: la seconda sostituisce il tram 4 con lo stesso tram 4. Il risultato è uguale a dopo la prima.
  4. Due DELETE: la prima toglie il treno 6; la seconda non trova più niente da togliere: 404.
  5. 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.

VerboLa prima voltaLa seconda voltaPerché
GET200200, stesso corpoLeggere non cambia niente
POST201, id 1201, id 2Ogni POST crea una cosa in più
PUT200200, stesso corpoSostituire con la stessa cosa dà la stessa cosa
DELETE204404La 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).

Terminale
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 Forbidden

200, 401, 403.

In italiano.

  1. B-12 è il badge del capo deposito: il registro è suo. 200, e il registro della notte.
  2. B-99 non è di nessuno: InfoMenta non sa chi sei. 401.
  3. B-01 è un badge vero: InfoMenta sa che sei Lucia Ferri. Ma il registro non è per una capotreno. 403.

Il disegno.

inizio GET /deposito/registro se il badge è sconosciuto sì: errore 401 Badge sconosciuto se il badge non è del capo deposito sì: errore 403 Solo per il capo deposito restituisci 200 e il registroGET /deposito/registroil badge èsconosciuto401 Badge sconosciutoil badge non è delcapo deposito403 Solo per il capodepositorestituisci 200 e ilregistronosìnosì
Prima chi sei, poi cosa puoi

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.

BadgeInfoMenta sa chi sei?Puoi leggere il registro?Codice
B-12Sì, Ernesto PozziSì200
B-99No—401
B-01Sì, Lucia FerriNo403

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.

Terminale
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/1

Per 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 Allowed

200, poi quattro codici che cominciano per 4: 404, 422, 422, 405.

In italiano.

  1. Da Porta Codice a Piazza Query: tutto giusto. 200, e il viaggio.
  2. La stazione 9 non c'è. La richiesta è scritta bene, ma chiede una cosa che non esiste: 404.
  3. Manca a. Il viaggio vuole due numeri, e FastAPI lo sa: risponde 422 da solo, prima di entrare nella funzione che calcola il viaggio.
  4. abc al posto di un numero di stazione: anche questo lo vede FastAPI da solo. 422, non 404: la stazione abc non la cerca neanche.
  5. Il percorso /stazioni/1 esiste, ma solo con GET. Con DELETE: 405.

Il disegno.

inizio GET /viaggio?da=…&a=… se da o a manca o non è un numero sì: errore 422 Lo dice FastAPI se una stazione non esiste sì: errore 404 Lo dice la funzione restituisci 200 e il viaggioGET /viaggio?da=…&a=…da o a manca o non èun numero422 Lo dice FastAPIuna stazione nonesiste404 Lo dice la funzionerestituisci 200 e il viaggionosìnosì
Chi dice no a GET /viaggio

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.

RichiestaCodiceChi dice noCosa non va
GET /viaggio?da=1&a=5200nessunoniente
GET /viaggio?da=1&a=9404la funzione di InfoMentala cosa chiesta non esiste
GET /viaggio?da=1422FastAPI, da soloi dati: ne manca uno
GET /stazioni/abc422FastAPI, da soloi dati: non è un numero
DELETE /stazioni/1405FastAPI, da soloil 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.