Vai al contenuto
code-to-code

Apro l'indice…

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

HTTP e API1. Il viaggio di una richiestap. 23

Il viaggio di una richiesta, se qualcosa va storto

I messaggi da leggere e le cose che si confondono

In questo capitolo non scrivi codice che gira: leggi viaggi già fatti. Gli errori quindi sono di due tipi. Quelli con un messaggio (un test, curl, il server che non parte) e quelli senza: due pezzi del viaggio che si somigliano e si scambiano. Prima i primi.

Nei test

LeggiVuol direCosa fai
AssertionError: Manca la risposta: al posto di None scrivi la tua.Al posto della risposta c'è ancora NoneScrivi la tua risposta dopo l'=, e salva il file
AssertionError: Non è questa. Rileggi …La risposta c'è, ma non è giustaRileggi la domanda parola per parola: chiede il nome o il valore? il percorso con o senza la query? un numero o un testo? Poi le confusioni qui sotto
SyntaxError: invalid syntax, con una freccia sotto la tua rispostaUn testo senza virgolette: RISPOSTA_1B = /treni. Python prova a leggerlo come codice, e non ci riesceLe virgolette: RISPOSTA_1B = "/treni". I numeri invece vanno senza
NameError: name 'NoneType' is not defined (o 'null', 'GET'…)Una parola senza virgolette: Python cerca una variabile con quel nome, e non c'èTra virgolette: "NoneType"
ERROR collecting palestra/test_… e Interrupted: 1 error during collectionIl file dell'esercizio non si carica, quindi nessun test parteGuarda le righe che cominciano con E: dicono il file, la riga e il motivo

Per esempio, con RISPOSTA_1B = /treni senza virgolette, pytest palestra/test_domanda_di_lucia.py -v si ferma così (accorciato):

________________________ ERROR collecting palestra/test_domanda_di_lucia.py ________________________
…
palestra/test_domanda_di_lucia.py:9: in <module>
    from domanda_di_lucia import RISPOSTA_1A, RISPOSTA_1B, RISPOSTA_1C, RISPOSTA_1D
E     File "~/corso/http-viaggio-di-una-richiesta/palestra/domanda_di_lucia.py", line 30
E       RISPOSTA_1B = /treni
E                     ^
E   SyntaxError: invalid syntax
===================================== short test summary info ======================================
ERROR palestra/test_domanda_di_lucia.py
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Interrupted: 1 error during collection !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Si legge dal basso, come in Leggere un traceback: l'errore è un SyntaxError, nel file domanda_di_lucia.py, alla riga 30, e la freccia indica proprio la / senza virgolette.

Con curl e con InfoMenta

LeggiVuol direCosa fai
curl: (7) Failed to connect to 127.0.0.1 port 8000 after 0 ms: Couldn't connect to serverSu quella porta non risponde nessuno: InfoMenta è spentaAccendila nel primo terminale (fastapi dev palestra/infomenta.py) e lascialo aperto. curl va nel secondo
zsh: no matches found: http://127.0.0.1:8000/treni?stazione_id=5L'indirizzo è senza virgolette, e il terminale del Mac legge il ? a modo suoVirgolette doppie intorno all'indirizzo: curl -i "http://…". Su Ubuntu non c'è l'errore, ma con un & la query si taglia: virgolette sempre
curl: (3) URL rejected: Malformed input to a URL functionNell'indirizzo c'è uno spazioToglilo. Se lo spazio serve davvero, si scrive %20
HTTP/1.1 404 Not Found con il corpo {"detail":"Not Found"}Il server è acceso e ha risposto, ma quel percorso non esisteConfronta il percorso lettera per lettera: /partenza non è /partenze
command not found: fastapiIl venv è spentosource .venv/bin/activate, dalla cartella dello zip, poi di nuovo fastapi dev
ERROR: [Errno 48] Address already in use (su Ubuntu [Errno 98])InfoMenta, o un altro server, è già accesa in un altro terminaleUsa quella che c'è già, oppure Ctrl+C di là e riaccendi qui. In alternativa --port 8001, e negli indirizzi 8001
Il browser di Windows non apre http://127.0.0.1:8000Il server deve girare nel terminale di Ubuntu (WSL)fastapi dev nel terminale di Ubuntu; poi l'indirizzo nel browser di Windows funziona

Il 404 di un percorso sbagliato, dal vivo:

Terminale
curl -i http://127.0.0.1:8000/partenza
HTTP/1.1 404 Not Found
date: Thu, 19 Nov 2026 15:55:35 GMT
server: uvicorn
content-length: 22
content-type: application/json

{"detail":"Not Found"}

Una risposta è arrivata, quindi InfoMenta è accesa: il viaggio è andato, ma all'indirizzo sbagliato. Con il server spento invece la risposta non arriva proprio, e parla curl, con il suo (7).

Le confusioni

Gli errori più frequenti del capitolo non hanno un messaggio: sono due pezzi del viaggio che si somigliano. Quasi sempre è una di queste coppie.

Il percorso e la query. Nella riga di richiesta stanno attaccati: /treni?stazione_id=5. Ma il percorso finisce al ?, ed è /treni. Quello che segue è la query.

Il nome e il valore di un header. In content-type: application/json il nome è prima dei due punti, il valore dopo. Leggi bene cosa chiede la domanda.

L'header della richiesta e quello della risposta. In una POST Content-Type c'è due volte: nella richiesta dice di che tipo è il corpo che mandi, nella risposta quello che ricevi. La richiesta finisce alla sua riga vuota; la risposta comincia con HTTP/1.1 e il codice.

Il codice di stato e il codice del treno. 200 è il codice di stato, nella prima riga della risposta. "M16" è il codice del treno, un campo del corpo. Stessa parola, due cose.

null e None, false e False. Le prime sono parole del JSON, le seconde di Python. json.loads fa la traduzione: in un file Python si scrive sempre None e False.

Il valore e il suo tipo. None è un valore, e il suo tipo si chiama NoneType. [ … ] in JSON è una lista: in Python, list. Quando la domanda dice «come lo scrive type()», vuole il tipo.

127.0.0.1 non è un sito. Vuol dire «questo computer», sempre. Se Rosa scrivesse http://127.0.0.1:8000 sul suo telefono, il telefono cercherebbe InfoMenta dentro il telefono. Sul tuo computer funziona perché InfoMenta è accesa lì.

Se il problema non è il codice

pytest: command not found, No module named pytest, il pannello Testing vuoto, No module named 'domanda_di_lucia': non sono le tue risposte, è l'ambiente. È il guaio più comune in assoluto, e ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente. Per i guai del server (Address already in use, /docs che non si apre) c'è la sezione FastAPI del Pronto soccorso.