Vai al contenuto
code-to-code

Apro l'indice…

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

HTTP e API2. Verbi e codicip. 44

Verbi e codici, le soluzioni

Il perché di ogni codice, e la risposta vera di InfoMenta

Per ogni domanda, sempre lo stesso ordine: in italiano (il ragionamento) → la risposta → dal vivo (quello che risponde davvero InfoMenta a curl -i). Per le domande più difficili, anche il passo per passo. In fondo a ogni esercizio, le trappole: le risposte sbagliate più comuni, e perché.

Hai sbagliato un codice ma la prima cifra era giusta? Sei già a metà strada: sapevi di chi era la colpa. Rileggi la riga della teoria per capire cosa distingue il tuo codice da quello giusto.

Le soluzioni complete

La stessa cartella, con il codice al posto di pass. Aprila dopo averci provato: i test sono gli stessi.

http-verbi-e-codici-soluzioni.zip16 KB

Tutte le risposte qui sotto sono state prese con InfoMenta appena accesa, nell'ordine delle domande.


1 · Prima dell'apertura

Domanda 1 · Vecchia Fiera

In italiano. Ernesto chiede la scheda della stazione 6. La stazione 6 esiste: è chiusa al pubblico, ma è nei dati di InfoMenta. La richiesta è andata bene, e la risposta è la scheda. Che la stazione sia chiusa lo dice il corpo, con "aperta":false, non il codice.

Python
RISPOSTA_1 = 200

Dal vivo.

HTTP/1.1 200 OK
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-length: 46
content-type: application/json

{"id":6,"nome":"Vecchia Fiera","aperta":false}

Domanda 2 · Di fretta

In italiano. Il percorso è /treno/1, al singolare. InfoMenta ha /treni/1, non /treno/1: una lettera di differenza, e il percorso non esiste. Il treno 1 c'è, ma la richiesta non arriva mai a cercarlo. Risponde FastAPI da solo, con il suo 404 di sempre: Not Found.

Python
RISPOSTA_2 = 404

Dal vivo.

HTTP/1.1 404 Not Found
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-length: 22
content-type: application/json

{"detail":"Not Found"}

Confrontalo con il 404 dell'esempio A, {"detail":"Treno non trovato"}: lì il percorso c'era, ed era il treno a mancare. Il detail ti dice quale dei due.

Domanda 3 · Il vecchio indirizzo

In italiano. /orari si è spostato per sempre su /partenze. InfoMenta non dà gli orari: risponde «vai là», con il 301 e il nuovo indirizzo nell'header location. Il browser, e Python se glielo chiedi, ci vanno da soli. curl -i no: senza altre opzioni si ferma alla prima risposta.

Python
RISPOSTA_3 = 301

Dal vivo.

HTTP/1.1 301 Moved Permanently
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-length: 0
location: /partenze?stazione_id=1

Il corpo è vuoto (content-length: 0). La query, ?stazione_id=1, InfoMenta l'ha portata con sé nel nuovo indirizzo. Con -L curl segue il rimando, e le risposte diventano due: il 301, poi il 200 di /partenze.

Terminale
curl -i -L "http://127.0.0.1:8000/orari?stazione_id=1"
HTTP/1.1 301 Moved Permanently
date: Thu, 19 Nov 2026 16:00:13 GMT
server: uvicorn
content-length: 0
location: /partenze?stazione_id=1

HTTP/1.1 200 OK
date: Thu, 19 Nov 2026 16:00:13 GMT
server: uvicorn
content-length: 220
content-type: application/json

[{"ora":"05:42","treno":"M12","stazione_id":1,"direzione":"Piazza Query"},{"ora":"05:54","treno":"M14","stazione_id":1,"direzione":"Piazza Query"},{"ora":"06:06","treno":"M12","stazione_id":1,"direzione":"Piazza Query"}]

Le trappole

Il codice sbagliatoCosa succedeIl test rosso
RISPOSTA_1 = 404«È chiusa, quindi non c'è». Ma chiusa al pubblico non vuol dire assente dai dati: la scheda c'ètest_1_vecchia_fiera
RISPOSTA_1 = 403«È chiusa, quindi è vietata». Il 403 riguarda chi fa la richiesta, non la stazione: nessuno ha chiesto un badgetest_1_vecchia_fiera
RISPOSTA_2 = 200«Il treno 1 c'è». Ma il percorso /treno/1 non esiste: InfoMenta non arriva a cercarlotest_2_di_fretta
RISPOSTA_2 = 400«La richiesta è scritta male». Il 400 lo manda una funzione che ha ricevuto la richiesta; qui non c'è nessuna funzione per /treno. Un percorso che non c'è è sempre 404test_2_di_fretta
RISPOSTA_3 = 200È quello che vedi nel browser, che segue il rimando da solo. curl -i si ferma al 301test_3_il_vecchio_indirizzo

2 · I treni del giorno

Domanda 4 · Un treno nuovo

In italiano. Una POST con i dati giusti crea il treno. «Tutto bene» sarebbe 200, ma per una cosa creata il codice è più preciso: 201, Created. Nel corpo c'è il treno, con l'id che ha scelto InfoMenta: il 7.

Python
RISPOSTA_4 = 201

Dal vivo.

HTTP/1.1 201 Created
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-length: 79
content-type: application/json

{"codice":"M18","tipo":"metro","vagoni":4,"stazione_id":1,"guasto":null,"id":7}

Se la mandi una seconda volta, senza riaccendere InfoMenta, il codice M18 è già usato:

HTTP/1.1 409 Conflict
date: Thu, 19 Nov 2026 16:00:13 GMT
server: uvicorn
content-length: 48
content-type: application/json

{"detail":"Codice già usato da un altro treno"}

Domanda 5 · Le porte del T09

In italiano. Il verbo è PUT, e la PUT sostituisce il treno intero: vuole tutti i campi. Ernesto ne manda uno solo, guasto. Mancano codice, tipo, vagoni e stazione_id: FastAPI risponde 422 da solo, e la funzione di InfoMenta non parte nemmeno. Il T09, per InfoMenta, ha ancora le porte bloccate.

Python
RISPOSTA_5 = 422

Dal vivo.

HTTP/1.1 422 Unprocessable Entity
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-length: 375
content-type: application/json

{"detail":[{"type":"missing","loc":["body","codice"],"msg":"Field required","input":{"guasto":null}},{"type":"missing","loc":["body","tipo"],"msg":"Field required","input":{"guasto":null}},{"type":"missing","loc":["body","vagoni"],"msg":"Field required","input":{"guasto":null}},{"type":"missing","loc":["body","stazione_id"],"msg":"Field required","input":{"guasto":null}}]}

Passo per passo. Il detail ha quattro errori, uno per campo che manca:

locmsginput: cosa è arrivato
["body","codice"]Field required{"guasto":null}
["body","tipo"]Field required{"guasto":null}
["body","vagoni"]Field required{"guasto":null}
["body","stazione_id"]Field required{"guasto":null}

Le due richieste che avrebbero funzionato:

Terminale
# la PUT, con il treno intero
curl -i -X PUT http://127.0.0.1:8000/treni/5 \
     -H "Content-Type: application/json" \
     -d '{"codice": "T09", "tipo": "tram", "vagoni": 1, "stazione_id": 4, "guasto": null}'

# la PATCH, con il solo campo che cambia
curl -i -X PATCH http://127.0.0.1:8000/treni/5 \
     -H "Content-Type: application/json" \
     -d '{"guasto": null}'

Tutte e due rispondono 200 OK, con il T09 e "guasto":null.

Domanda 6 · In revisione

In italiano. Una DELETE su un treno che c'è: InfoMenta lo toglie, e non ha niente da mostrare. Il codice per «fatto, niente da restituire» è 204, No Content: dopo gli header, il corpo è vuoto.

Python
RISPOSTA_6 = 204

Dal vivo.

HTTP/1.1 204 No Content
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-type: application/json

La seconda volta, il treno 2 non c'è più:

HTTP/1.1 404 Not Found
date: Thu, 19 Nov 2026 16:00:13 GMT
server: uvicorn
content-length: 30
content-type: application/json

{"detail":"Treno non trovato"}

Le trappole

Il codice sbagliatoCosa succedeIl test rosso
RISPOSTA_4 = 200La prima cifra è giusta, ma per una cosa creata c'è un codice suotest_4_un_treno_nuovo
RISPOSTA_5 = 200È la risposta di una PATCH. La PUT vuole il treno intero: con un campo solo, 422test_5_le_porte_del_t09
RISPOSTA_6 = 200Il 200 vuol dire «ecco la risposta». Qui la risposta non c'è: il corpo è vuoto, e il codice lo dicetest_6_in_revisione

3 · Il giro di Nadia

Domanda 7 · Senza badge

In italiano. Senza l'header Authorization, InfoMenta non sa chi sta chiedendo. Non può nemmeno chiedersi se Nadia può leggere il registro: prima deve sapere chi è. È la domanda «chi sei?»: 401. La risposta porta anche l'header www-authenticate: Bearer, cioè «mandami un badge».

Python
RISPOSTA_7 = 401

Dal vivo.

HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
www-authenticate: Bearer
content-length: 67
content-type: application/json

{"detail":"Chi sei? Manca il badge: Authorization: Bearer <badge>"}

Domanda 8 · Il badge di Marta

In italiano. Il badge B-07 è vero: InfoMenta sa che è Marta Villa. La prima domanda, «chi sei?», ha una risposta. La seconda, «puoi?», no: il registro è solo per il capo deposito. «So chi sei, ma non puoi»: 403.

Python
RISPOSTA_8 = 403

Dal vivo.

HTTP/1.1 403 Forbidden
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-length: 79
content-type: application/json

{"detail":"Marta Villa, il registro del deposito è solo per il capo deposito"}

Domanda 9 · I tornelli di Vecchia Fiera

In italiano. Nadia ha scritto la richiesta giusta: il percorso esiste, la stazione 6 esiste. Il problema è dentro InfoMenta, che divide i passeggeri per i tornelli aperti, e a Vecchia Fiera i tornelli sono zero. In Python una divisione per zero è un ZeroDivisionError. Nessuno l'ha previsto, nessun try la ferma, e il server risponde come risponde quando si rompe: 500. Colpa del server, non di Nadia.

Python
RISPOSTA_9 = 500

Dal vivo.

HTTP/1.1 500 Internal Server Error
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-length: 21
content-type: text/plain; charset=utf-8

Internal Server Error

Il client non sa niente di più: Internal Server Error, e basta. Il perché sta nell'altro terminale, quello del server.

Passo per passo. Nel terminale del server compare (accorciato: le righe in mezzo sono di uvicorn e di FastAPI):

INFO:     127.0.0.1:59859 - "GET /stazioni/6/affluenza HTTP/1.1" 500 Internal Server Error
ERROR:    Exception in ASGI application
Traceback (most recent call last):
…
  File "~/corso/http-verbi-e-codici/palestra/infomenta.py", line 215, in affluenza
    per_tornello = PASSEGGERI_OGGI[stazione_id] // TORNELLI_APERTI[stazione_id]
                   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
ZeroDivisionError: integer division or modulo by zero

Si legge dal basso, come in Leggere un traceback:

  1. L'ultima riga dice cosa: ZeroDivisionError, una divisione per zero.
  2. La riga con i ^^ dice quale pezzo: il //, la divisione.
  3. La riga File … line 215, in affluenza dice dove: infomenta.py, riga 215, nella funzione affluenza.

È un bug lasciato apposta in InfoMenta. Quando le API le scrivi tu, un 500 vuol dire sempre una cosa sola: guarda il terminale del server.

Le trappole

Il codice sbagliatoCosa succedeIl test rosso
RISPOSTA_7 = 403Il 403 vuol dire «so chi sei». Senza badge InfoMenta non lo sa: prima viene «chi sei?»test_7_senza_badge
RISPOSTA_8 = 401Il badge di Marta è vero: InfoMenta sa chi è. Il problema non è chi è, ma cosa può faretest_8_il_badge_di_marta
RISPOSTA_9 = 404«Vecchia Fiera è chiusa». Ma la stazione 6 esiste: lo hai visto nella domanda 1test_9_i_tornelli_di_vecchia_fiera
RISPOSTA_9 = 503La prima cifra è giusta, colpa del server. Ma il 503 è un cartello messo apposta («torna dopo»); qui il server si è rotto per sbagliotest_9_i_tornelli_di_vecchia_fiera

4 · L'app di Rosa

Domanda 10 · Da Largo Lista a Largo Lista

In italiano. da=3 e a=3 sono due numeri, come vuole il viaggio: FastAPI non ha niente da dire, e passa la richiesta alla funzione. La funzione trova la stazione 3, e poi si accorge che partenza e arrivo sono uguali: un viaggio così non ha senso. È lei a rispondere «richiesta sbagliata»: 400, Bad Request.

Python
RISPOSTA_10 = 400

Dal vivo.

HTTP/1.1 400 Bad Request
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
content-length: 54
content-type: application/json

{"detail":"Partenza e arrivo sono la stessa stazione"}

Guarda il detail: è una frase sola, scritta da chi ha fatto InfoMenta. Il detail di un 422 di FastAPI, invece, è una lista di errori con loc e msg, come nella domanda 5.

Domanda 11 · Il quarto annuncio

In italiano. I primi tre annunci passano: 201, 201, 201. Il quarto arriva quando l'altoparlante ne ha già ricevuti tre in un minuto: troppe richieste, rallenta. 429, Too Many Requests.

Python
RISPOSTA_11 = 429

Passo per passo. Le quattro POST, viste dal terminale del server:

INFO:     127.0.0.1:59861 - "POST /annunci HTTP/1.1" 201 Created
INFO:     127.0.0.1:59862 - "POST /annunci HTTP/1.1" 201 Created
INFO:     127.0.0.1:59863 - "POST /annunci HTTP/1.1" 201 Created
INFO:     127.0.0.1:59864 - "POST /annunci HTTP/1.1" 429 Too Many Requests
POSTAnnunci nell'ultimo minuto, primaCodiceId
102011
212012
322013
43: il massimo429—

Dal vivo, il quarto:

HTTP/1.1 429 Too Many Requests
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
retry-after: 60
content-length: 60
content-type: application/json

{"detail":"Troppi annunci: l'altoparlante riposa un minuto"}

L'header retry-after: 60 dice quando riprovare: fra 60 secondi. Se lo provi dal vivo, ogni annuncio nuovo prende 429 finché non è passato un minuto dal primo dei tre.

Domanda 12 · L'ascensore

In italiano. Gli ascensori sono in manutenzione: il servizio c'è, ma adesso è giù, e InfoMenta lo sa. Non si è rotto niente per sbaglio: è un cartello «torna più tardi». 503, Service Unavailable. L'header retry-after: 3600 dice fra quanto: 3600 secondi, un'ora.

Python
RISPOSTA_12 = 503

Dal vivo.

HTTP/1.1 503 Service Unavailable
date: Thu, 19 Nov 2026 16:00:11 GMT
server: uvicorn
retry-after: 3600
content-length: 57
content-type: application/json

{"detail":"Ascensori in manutenzione: riprova dopo le 6"}

Le trappole

Il codice sbagliatoCosa succedeIl test rosso
RISPOSTA_10 = 422Il 422 lo manda FastAPI quando i dati non vanno: un campo che manca, abc al posto di un numero. Qui i dati sono giusti: è la domanda che non ha senso, e lo decide la funzionetest_10_da_largo_lista_a_largo_lista
RISPOSTA_11 = 201È il codice dei primi tre. Il quarto supera il limitetest_11_il_quarto_annuncio
RISPOSTA_12 = 500La prima cifra è giusta. Ma il 500 è un incidente, un'eccezione che nessuno aspettava; la manutenzione è annunciata, e ha il suo codicetest_12_l_ascensore

I dodici, in una riga ciascuno

Le risposte giuste, una per codice, nell'ordine dei numeri:

CodiceDomandaPerché
2001 · Vecchia FieraLa scheda c'è; «chiusa» sta nel corpo
2014 · Un treno nuovoUna POST che crea
2046 · In revisioneUna DELETE: fatto, niente da mostrare
3013 · Il vecchio indirizzoSpostato per sempre, e curl non segue
40010 · Da Largo Lista a Largo ListaDati giusti, domanda senza senso
4017 · Senza badgeChi sei?
4038 · Il badge di MartaSo chi sei, ma non puoi
4042 · Di frettaIl percorso non esiste
4225 · Le porte del T09La PUT vuole tutti i campi
42911 · Il quarto annuncioTroppe richieste
5009 · I tornelli di Vecchia FieraIl server si è rotto: divisione per zero
50312 · L'ascensoreGiù apposta: riprova più tardi