Chi sei, cosa puoi fare, esercizi spiegati
Cinque esempi, una domanda alla volta
- 20 minuti di lettura
Cinque esempi, dal più semplice. Ognuno ha lo stesso ritmo:
- Prevedi: leggi la richiesta e scrivi su un foglio che codice risponde il server. Prima di aprire la risposta.
- In italiano: cosa succede, a parole.
- Passo per passo: le tre domande del server, una alla volta.
- Cosa portiamo a casa: la cosa da ricordare.
I primi quattro sono richieste all'app degli abbonati della Linea Menta. Gli abbonati sono tre:
| Username | Nome | Tessera |
|---|---|---|
rosa | Rosa Bellini | A-101 |
teo | Teo Galbiati | A-205 |
ugo | Ugo Pirola | A-307 |
Le richieste sono fatte con curl -i, che mostra anche la prima riga della risposta, quella con il codice: lo trovi nel capitolo Postman e curl.
A · Teo senza biglietto
Teo apre l'app sul telefono, ma non ha ancora fatto il login. L'app chiede lo stesso la sua tessera:
curl -i http://127.0.0.1:8000/tessere/A-205Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 31
content-type: application/json
{"detail":"Manca il biglietto"}401: il server non sa chi sei.
In italiano. Nella richiesta non c'è l'header Authorization: nessun biglietto. Per il server, chi chiede è uno sconosciuto. Si ferma alla prima domanda, e non guarda nemmeno se la tessera A-205 esiste.
E se il biglietto c'è, ma è inventato?
curl -i http://127.0.0.1:8000/tessere/A-205 -H "Authorization: Bearer biglietto-inventato"Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 33
content-type: application/json
{"detail":"Biglietto non valido"}Ancora 401, con un altro messaggio. Un biglietto che non vale, per il server, è come non averlo.
Passo per passo.
| Domanda | Senza biglietto | Con biglietto-inventato |
|---|---|---|
| 1 · Chi sei? | non lo so: manca il biglietto → 401 | non lo so: il biglietto non vale → 401 |
| 2 · La tessera c'è? | non ci arriva | non ci arriva |
| 3 · Puoi? | non ci arriva | non ci arriva |
Cosa portiamo a casa. 401 vuol dire «il problema è il biglietto»: manca, è falso, è scaduto. La cura è sempre la stessa: il login, e un biglietto nuovo.
B · Teo con il biglietto: la sua tessera, e quella di Rosa
Teo fa il login, con il suo username e la sua password:
curl -s -X POST http://127.0.0.1:8000/login -H "Content-Type: application/json" -d '{"username": "teo", "password": "tram-delle-sette"}'{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ0ZW8iLCJleHAiOjE3OTUxMTMxNDV9.g0nzbW3WcGE04zrl7xO7ZcWKI0nfrh0SFG4lJsSbYvA","token_type":"bearer"}Quella stringa lunga in access_token è il biglietto di Teo. Com'è fatta dentro lo vedi nel capitolo Il biglietto: JWT; per ora ti basta sapere che è di Teo e che vale 30 minuti.
Per non incollarla a ogni richiesta, la mettiamo in una variabile del terminale, BIGLIETTO. Poi $BIGLIETTO la usa:
BIGLIETTO=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi… # incolla il biglietto intero, senza virgoletteAdesso Teo chiede due tessere: prima la sua, poi quella di Rosa.
curl -i http://127.0.0.1:8000/tessere/A-205 -H "Authorization: Bearer $BIGLIETTO"
curl -i http://127.0.0.1:8000/tessere/A-101 -H "Authorization: Bearer $BIGLIETTO"Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 200 OK
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 67
content-type: application/json
{"numero":"A-205","titolare":"teo","abbonamento":"mensile, zona 1"}HTTP/1.1 403 Forbidden
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 38
content-type: application/json
{"detail":"Questa tessera non è tua"}La sua: 200. Quella di Rosa: 403.
In italiano. Lo stesso biglietto, la stessa persona, due risposte diverse. Il server sa chi è, in tutte e due le richieste: è Teo. Cambia la tessera. La A-205 è sua: 200. La A-101 c'è, ma è di Rosa: 403.
Passo per passo.
| Domanda | GET /tessere/A-205 | GET /tessere/A-101 |
|---|---|---|
| 1 · Chi sei? | Teo: il biglietto vale | Teo: il biglietto vale |
| 2 · La tessera c'è? | sì, è di teo | sì, è di rosa |
| 3 · Puoi? | teo è teo: sì → 200 | teo non è rosa: no → 403 |
Cosa portiamo a casa. Il biglietto dice chi sei, non cosa puoi fare. Cosa puoi fare dipende da chi sei e da cosa chiedi.
C · La tessera che non c'è
Teo, sempre con il suo biglietto, sbaglia un numero e chiede la tessera A-999, che non esiste:
curl -i http://127.0.0.1:8000/tessere/A-999 -H "Authorization: Bearer $BIGLIETTO"Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 404 Not Found
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 32
content-type: application/json
{"detail":"Tessera non trovata"}In italiano. Chi sei: Teo, il biglietto vale. La tessera c'è? No. Il server si ferma alla seconda domanda: 404. Alla terza, «puoi?», non arriva nemmeno: per sapere di chi è una tessera, la tessera deve esserci.
Adesso la stessa richiesta, ma senza biglietto:
curl -i http://127.0.0.1:8000/tessere/A-999Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 31
content-type: application/json
{"detail":"Manca il biglietto"}401, non 404. La prima domanda viene prima: a uno sconosciuto il server non dice se la tessera A-999 esiste.
Passo per passo.
| Domanda | A-999, con il biglietto | A-999, senza biglietto |
|---|---|---|
| 1 · Chi sei? | Teo | non lo so → 401 |
| 2 · La tessera c'è? | no → 404 | non ci arriva |
| 3 · Puoi? | non ci arriva | non ci arriva |
Un 404 può arrivare anche da un'altra parte. Qui Teo sbaglia l'indirizzo, non il numero: tesere, con una esse sola.
curl -i http://127.0.0.1:8000/tesere/A-205 -H "Authorization: Bearer $BIGLIETTO"HTTP/1.1 404 Not Found
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 22
content-type: application/json
{"detail":"Not Found"}Il codice è lo stesso, il messaggio no. Not Found, in inglese, lo scrive FastAPI da solo: nessuna rotta ha quell'indirizzo, e la tua funzione non è nemmeno partita. Tessera non trovata lo scrive la tua rotta: è partita, ha cercato, non ha trovato.
Cosa portiamo a casa. Davanti a un 404, leggi il detail. Se è Not Found, controlla l'indirizzo; se è il tuo messaggio, la cosa che cerchi non c'è.
D · Il login sbagliato
Ugo Pirola fa il login due volte. La prima sbaglia la password: scrive ponte-ciclo-24 invece di ponte-ciclo-42. La seconda scrive la password giusta, ma come username usa nome e cognome:
curl -i -X POST http://127.0.0.1:8000/login -H "Content-Type: application/json" -d '{"username": "ugo", "password": "ponte-ciclo-24"}'
curl -i -X POST http://127.0.0.1:8000/login -H "Content-Type: application/json" -d '{"username": "ugo.pirola", "password": "ponte-ciclo-42"}'Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 42
content-type: application/json
{"detail":"Username o password sbagliati"}HTTP/1.1 401 Unauthorized
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 42
content-type: application/json
{"detail":"Username o password sbagliati"}Due risposte identiche, lettera per lettera.
In italiano. Il login fa una domanda sola: chi sei? Ugo non è riuscito a dimostrarlo, né la prima volta né la seconda: 401. E il server non dice quale pezzo era sbagliato.
Con lo username giusto e la password giusta, invece:
curl -i -X POST http://127.0.0.1:8000/login -H "Content-Type: application/json" -d '{"username": "ugo", "password": "ponte-ciclo-42"}'HTTP/1.1 200 OK
date: Thu, 19 Nov 2026 18:02:25 GMT
server: uvicorn
content-length: 162
content-type: application/json
{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1Z28iLCJleHAiOjE3OTUxMTMxNDV9.foTkhKaQRirRW1EFeYH_Sp84noFC8zKx5bOSN_d_V7A","token_type":"bearer"}Passo per passo. Al login la domanda è una sola, «chi sei?». Per rispondere, il server controlla due cose, e vuole un sì da tutte e due:
| Il login di Ugo | Lo username c'è? | La password è la sua? | Risposta |
|---|---|---|---|
ugo, ponte-ciclo-24 | sì | no | 401 |
ugo.pirola, ponte-ciclo-42 | no | non c'è niente con cui confrontarla | 401 |
ugo, ponte-ciclo-42 | sì | sì | 200, e il biglietto |
Come fa il server a controllare una password senza tenerla scritta da nessuna parte lo vedi nel capitolo Le password.
Cosa portiamo a casa. Al login, username o password sbagliati: 401, e lo stesso messaggio. Il server non aiuta chi prova a indovinare.
E · Le tre domande, in Python
Le tre domande si possono scrivere in Python, senza server e senza login: una funzione che riceve chi chiede e cosa chiede, e restituisce il codice. chi è None quando il biglietto manca o non vale: come si legge un biglietto lo vedi nel capitolo 6.
Questo lo puoi provare tu: salvalo in un file, tre_domande.py, e lancialo con python3 tre_domande.py.
titolari = {"A-101": "rosa", "A-205": "teo", "A-307": "ugo"}
def codice_della_risposta(chi: str | None, numero: str) -> int:
if chi is None: # 1. chi sei? Non lo so
return 401
titolare = titolari.get(numero)
if titolare is None: # 2. la tessera c'è? No
return 404
if titolare != chi: # 3. puoi? Non è tua
return 403
return 200
print(codice_della_risposta("teo", "A-205"))
print(codice_della_risposta(None, "A-205"))
print(codice_della_risposta("teo", "A-101"))
print(codice_della_risposta("teo", "A-999"))
print(codice_della_risposta(None, "A-999"))Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
200
401
403
404
401Il dizionario che la funzione consulta:
In italiano. Tre if, uno per domanda, nell'ordine del disegno. Ogni return ferma la funzione: le domande dopo non si fanno. Se nessun if scatta, la risposta è 200.
Il disegno.
Passo per passo.
| Chiamata | chi is None? | titolare | titolare != chi? | Risultato |
|---|---|---|---|---|
"teo", "A-205" | no | "teo" | no | 200 |
None, "A-205" | sì | — | — | 401 |
"teo", "A-101" | no | "rosa" | sì | 403 |
"teo", "A-999" | no | None | — | 404 |
None, "A-999" | sì | — | — | 401 |
E se l'ordine cambia? Proviamo a chiedere «puoi?» prima di «la tessera c'è?», leggendo la tessera con le quadre. Un file nuovo, ordine_sbagliato.py:
titolari = {"A-101": "rosa", "A-205": "teo", "A-307": "ugo"}
def codice_della_risposta(chi: str | None, numero: str) -> int:
if chi is None:
return 401
if titolari[numero] != chi: # prima «puoi?»…
return 403
return 200
print(codice_della_risposta("teo", "A-101"))
print(codice_della_risposta("teo", "A-999"))Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
403
Traceback (most recent call last):
…
if titolari[numero] != chi: # prima «puoi?»…
~~~~~~~~^^^^^^^^
KeyError: 'A-999'Con A-101 va bene. Con A-999 la funzione esplode: per chiedere di chi è la tessera, la tessera deve esserci. In un'API, il client riceverebbe un 500.
E se la tessera si cerca per prima, prima ancora di chiedere chi sei? Un altro file, prima_il_404.py:
titolari = {"A-101": "rosa", "A-205": "teo", "A-307": "ugo"}
def codice_della_risposta(chi: str | None, numero: str) -> int:
titolare = titolari.get(numero)
if titolare is None: # prima «la tessera c'è?»…
return 404
if chi is None: # …poi «chi sei?»
return 401
if titolare != chi:
return 403
return 200
print(codice_della_risposta(None, "A-101"))
print(codice_della_risposta(None, "A-102"))Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
401
404Nessun errore, e proprio per questo è pericoloso. Uno sconosciuto, senza biglietto, prova due numeri: 401 per A-101, 404 per A-102. Adesso sa che la A-101 esiste e la A-102 no. Provando tutti i numeri, avrebbe l'elenco delle tessere.
Cosa portiamo a casa. L'ordine non è un dettaglio: chi sei, la cosa c'è, puoi. Ogni domanda usa la risposta di quella prima.
Pronto? Nella palestra ti aspettano otto richieste al portale del personale della Linea Menta: per ognuna, il codice lo prevedi tu.