Postman e curl, se qualcosa va storto
Gli errori che vedrai, e le uscite
Gli errori che vedrai di più con curl e Postman. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. Quasi tutti nascono da due cause: il server è spento, o la richiesta non è fatta come la vuole.
Per la prima cosa a cui guardare, ricorda: curl -i (o in Postman la riga del codice sotto la risposta). Il codice dice da che parte è lo sbaglio. Cosa vuol dire ogni codice lo trovi in Verbi e codici.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
curl: (7) Failed to connect to 127.0.0.1 port 8000 | Il server è spento, o è su un'altra porta | Nel primo terminale: fastapi dev api/deposito.py. Se ha cambiato porta, aggiorna BASE_URL |
Postman: Could not send request | Server spento, oppure stai usando Postman nel browser | Accendi il server. Usa l'app desktop |
curl: (3) URL rejected: Malformed input to a URL function | Nell'indirizzo c'è uno spazio | Indirizzo tra virgolette doppie, %20 al posto dello spazio |
zsh: no matches found: http://127.0.0.1:8000/treni?tipo=tram | Indirizzo con ? senza virgolette: zsh lo legge come un jolly | Tra virgolette doppie: "http://127.0.0.1:8000/treni?tipo=tram" |
422 Unprocessable Entity, Input should be a valid dictionary or object | Il corpo c'è ma la centrale non l'ha letto come JSON | Con curl: aggiungi -H "Content-Type: application/json". In Postman: Body → raw → JSON, non Text |
422, con Field required | Nel corpo manca un campo (con una PUT, il treno va mandato intero) | Leggi la risposta: dice quali campi mancano in loc |
422, con JSON decode error | Il JSON è scritto male: virgolette semplici dentro il corpo, una virgola in più | Il JSON vuole le virgolette doppie dentro. Con curl, il corpo tra virgolette semplici |
401 Unauthorized su /me | Manca il biglietto, o è scritto male, o è scaduto | Header Authorization: Bearer e il biglietto (spazio compreso). Rifai il login: dopo un riavvio del server i biglietti vecchi non valgono più |
In Postman {{biglietto}} o {{baseUrl}} resta rosso | La variabile non esiste in questa collezione | Collezione → Variables. Per biglietto: Send del login con lo script nella scheda Scripts → Post-response |
404 Not Found con Nessun treno con il codice … | Il codice non c'è: hai già cancellato quel treno, o hai sbagliato a scriverlo | Guarda l'elenco: curl "$BASE_URL/treni" |
409 Conflict, Il treno M22 c'è già | La POST ha già avuto effetto | Non è un guasto: il treno c'è. Per ricominciare, spegni e riaccendi il server |
| curl non stampa niente | Con -s e un 204 (o una DELETE senza -i) non c'è niente da stampare | Aggiungi -i: vedi la riga del codice |
In nome.sh non c'è ancora nessun comando curl (nel test) | Il file è ancora com'era | Scrivi il comando sotto l'ultima riga, non in un commento |
In nome.sh scrivi l'indirizzo come "$BASE_URL/…" (nel test) | Hai scritto http://127.0.0.1:8000/… per intero | Metti "$BASE_URL/percorso": il test usa un server suo |
Address already in use all'accensione del server | La porta 8000 è occupata da un altro server | Spegni l'altro (Ctrl+C nel suo terminale), oppure fastapi dev api/deposito.py --port 8001 e export BASE_URL=http://127.0.0.1:8001 |
Gli errori che non danno errori
Con curl i più difficili sono quelli senza messaggio: il comando gira, la risposta sembra a posto, ma il test è rosso.
Il verbo dimenticato. curl -i "$BASE_URL/treni/M16" senza -X DELETE è una GET: risponde 200 e il treno resta. Il codice è l'unico indizio.
Il filtro sbagliato. Una lista di treni arriva comunque. Guarda quali treni ci sono.
Il biglietto vecchio. Ha funzionato un'ora fa, adesso 401: i biglietti scadono, e il server riacceso ha una chiave nuova.
Se il problema non è la richiesta
Il server non parte (fastapi: command not found) o pytest non parte: è il venv spento, non curl. Ha una pagina sua: pytest non parte, o non trova niente. Per le cure brevi di Postman e login: Pronto soccorso.