Vai al contenuto
code-to-code

Apro l'indice…

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

HTTP e API3. Fare richiestep. 81

Fare richieste, se qualcosa va storto

Due terminali, due indizi

Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.

Quando una richiesta va storta, gli indizi sono due, uno per terminale:

  • Il terminale del client (curl, Python) dice cosa è tornato indietro.
  • Il terminale del server dice cosa è arrivato. Se la riga della tua richiesta non c'è proprio, la richiesta non è mai arrivata: il guaio è prima, nel collegamento o nell'indirizzo. Se c'è, leggi il percorso e il codice.

Un traceback di Python si legge dal basso, come in Leggere un traceback. Con httpx è lungo, perché passa dentro la libreria: cerca le righe con il tuo file.

LeggiVuol direCosa fai
curl: (7) Failed to connect to 127.0.0.1 port 8000 after 0 ms: Couldn't connect to serverDall'altra parte non c'è nessuno: InfoMenta è spenta, o è accesa su un'altra portaNel primo terminale fastapi dev palestra/infomenta.py, e aspetta Application startup complete.
httpx.ConnectError: [Errno 61] Connection refused (su Ubuntu [Errno 111])Lo stesso, visto da Python: hai lanciato il file, ma InfoMenta è spentaCome sopra. I test invece non ne hanno bisogno: se il guaio è in pytest, non è questo
zsh: no matches found: http://127.0.0.1:8000/treni?tipo=tramSul Mac, l'indirizzo con il ? senza virgolette: zsh cerca un file con quel nomeVirgolette doppie attorno all'indirizzo
Una riga come [1] seguita da un numero, e il filtro dopo il & sparitoSu Ubuntu, l'indirizzo con il & senza virgolette: per bash & vuol dire «lancia in sottofondo», e l'indirizzo finisce lìVirgolette doppie. Vedi sotto, «gli errori che non danno errori»
422 con Input should be a valid dictionary or object to extract fields fromIl corpo è arrivato come modulo, non come JSON: -d senza l'header (o, in Python, data= al posto di json=)-H "Content-Type: application/json". In Python, json=
422 con JSON decode error e Expecting property name enclosed in double quotesIl JSON è tra virgolette doppie, e il terminale si è mangiato quelle di dentroIl JSON tra apici singoli: -d '{"testo": "Ciao"}'
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0).json() su una risposta senza corpo: un 204 (dopo una DELETE) o un 301Guarda prima status_code. Un 204 non ha niente da leggere: il codice è già la risposta
KeyError: 'codice' (o 'id', 'minuti'…)Hai letto il corpo di un errore: in un 404, un 400 o un 422 c'è solo detailPrima if risposta.status_code == …, poi .json()
TypeError: string indices must be integers, not 'str'Aspettavi una lista, ma è arrivato un errore, {"detail": …}: il for gira sulle sue chiavi, che sono stringheStampa risposta.status_code e risposta.json(): cosa ha risposto InfoMenta?
TypeError: list indices must be integers or slices, not strAspettavi un oggetto solo, ma è arrivata una lista. Di solito: l'id nella query (/treni?treno_id=5) invece che nel percorso (/treni/5)L'id nel percorso, con una f-string: f"/treni/{treno_id}"
TypeError: can only concatenate str (not "int") to strHai costruito l'indirizzo con + e un numeroparams= per la query, una f-string per il percorso
401 con un badge giustoL'header non è nella forma che InfoMenta vuoleAuthorization: Bearer B-12: la parola Bearer, uno spazio, il badge
Could not send request, in PostmanStai usando Postman nel browser: da lì 127.0.0.1 non si raggiungeL'app desktop. Su Windows quella di Windows, non dentro Ubuntu
assert None == …La funzione non restituisce niente: c'è ancora pass, manca il return, o il return è dentro un for che non gira maiIl return alla fine della funzione, fuori dal for

Ecco il traceback di httpx.ConnectError, accorciato. Le righe con il tuo file sono in fondo, e l'ultima dice cosa:

Traceback (most recent call last):
  File "~/corso/http-fare-richieste/.venv/lib/python3.12/site-packages/httpx/_transports/default.py", line 101, in map_httpcore_exceptions
    yield
…
httpcore.ConnectError: [Errno 61] Connection refused

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "~/corso/http-fare-richieste/palestra/orari.py", line 31, in <module>
    print(orari_di(client, 1))
          ^^^^^^^^^^^^^^^^^^^
  File "~/corso/http-fare-richieste/palestra/orari.py", line 21, in orari_di
    risposta = client.get("/partenze", params={"stazione_id": stazione_id})
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
…
httpx.ConnectError: [Errno 61] Connection refused

«Connection refused»: il computer ha risposto «su quella porta non c'è nessuno». Il tuo codice va bene, manca il server.

Gli errori che non danno errori

I più difficili sono quelli senza traceback: la risposta arriva, ma non è quella che volevi.

L'indirizzo tagliato al &. Su Ubuntu, senza virgolette:

Terminale
curl -s http://127.0.0.1:8000/treni?tipo=tram&stazione_id=4

Il terminale scrive [1] e un numero (cambia ogni volta), poi la risposta:

[{"codice":"T05","tipo":"tram","vagoni":1,"stazione_id":2,"guasto":null,"id":4},{"codice":"T09","tipo":"tram","vagoni":1,"stazione_id":4,"guasto":"porte bloccate","id":5}]

Volevi i tram di Ponte Ciclo, ne arrivano due: anche il T05, che sta a Via Variabile. Il terminale del server dice perché:

INFO:     127.0.0.1:59912 - "GET /treni?tipo=tram HTTP/1.1" 200 OK

E al comando dopo, il tuo terminale confessa quale comando ha lanciato davvero:

[1]+  Done                    curl -s http://127.0.0.1:8000/treni?tipo=tram

Il &stazione_id=4 non è mai partito: per il terminale & vuol dire «lancia il comando in sottofondo» (è il [1]), e quello che viene dopo è un altro comando. Con le virgolette:

Terminale
curl -s "http://127.0.0.1:8000/treni?tipo=tram&stazione_id=4"
[{"codice":"T09","tipo":"tram","vagoni":1,"stazione_id":4,"guasto":"porte bloccate","id":5}]

Sul Mac, invece, zsh si ferma prima e lo dice: zsh: no matches found. In tutti e due i casi la cura è la stessa.

Il JSON tra virgolette doppie. Il comando sembra giusto:

Terminale
curl -i -X POST http://127.0.0.1:8000/annunci -H "Content-Type: application/json" -d "{"testo": "Ciao"}"
HTTP/1.1 422 Unprocessable Entity
date: Thu, 19 Nov 2026 16:00:51 GMT
server: uvicorn
content-length: 158
content-type: application/json

{"detail":[{"type":"json_invalid","loc":["body",1],"msg":"JSON decode error","input":{},"ctx":{"error":"Expecting property name enclosed in double quotes"}}]}

Il terminale legge "{" come un pezzo tra virgolette, poi testo fuori, poi un altro pezzo… e le virgolette di dentro spariscono. A InfoMenta arriva {testo: Ciao}, che non è JSON. Fuori gli apici singoli, dentro le virgolette doppie: -d '{"testo": "Ciao"}'.

La POST mandata due volte. In Postman la richiesta resta pronta, e un Send in più crea un secondo annuncio, o fa un 409 se il codice c'è già (l'esempio C degli esercizi spiegati). Una GET si ripete senza danni, una POST no.

Il rimando seguito senza saperlo. Il TestClient segue i 301 da solo, httpx no. Una funzione che dal vivo funziona può essere rossa nei test, o il contrario. Se il codice di stato conta, scrivi follow_redirects=False (o True): non affidarti al comportamento di partenza.

I dati tornati come prima. Ogni volta che InfoMenta si riavvia, i treni creati e tolti tornano come all'inizio. Se un id non è quello che ti aspettavi, o un treno che avevi tolto è di nuovo lì, guarda il terminale del server: c'è stato un riavvio?

Se il problema non è il codice

command not found: fastapi o pytest: command not found: il venv è spento. source .venv/bin/activate, dalla cartella dello zip, in tutti e due i terminali.

Address already in use: c'è già un server sulla porta 8000, di solito InfoMenta accesa in un altro terminale che hai dimenticato. Sul Mac il messaggio è questo (su Ubuntu il numero è [Errno 98]):

INFO:     Will watch for changes in these directories: ['~/corso/http-fare-richieste']
ERROR:    [Errno 48] Address already in use

Trova il terminale e premi Ctrl+C. Oppure accendi questa su un'altra porta, fastapi dev palestra/infomenta.py --port 8001, e negli indirizzi scrivi 8001.

/docs o il tabellone non si aprono da Windows: InfoMenta deve girare nel terminale di Ubuntu; il browser di Windows la raggiunge su http://127.0.0.1:8000.

No module named pytest, il pannello Testing vuoto, No module named 'orari': non è il tuo codice, è l'ambiente. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente. Tutto il resto, nel Pronto soccorso.