Postman e curl, le soluzioni
Il ragionamento, il comando, le trappole
Per ogni richiesta, sempre lo stesso ordine: in italiano → il comando → le trappole. Per le più difficili, anche il passo per passo.
Il tuo comando è diverso ma i test sono verdi? Probabilmente va bene: con curl le strade giuste sono tante (-X POST scritto o no, virgolette semplici o doppie dove serve, opzioni in un altro ordine). Confronta il ragionamento, non le singole lettere. E leggi comunque le trappole: alcune danno una risposta che sembra giusta.
Le soluzioni complete
La stessa cartella, con il codice al posto di pass. Aprila dopo averci provato: i test sono gli stessi.
Nello zip delle soluzioni ci sono gli stessi file .sh, con il comando già scritto.
1 · Tutti i treni
In italiano. Chiedo la lista dei treni e voglio vedere anche il codice e gli header.
curl -i "$BASE_URL/treni"Le trappole.
| Il comando sbagliato | Cosa succede | Il test rosso |
|---|---|---|
curl "$BASE_URL/treni" | Stampa solo il corpo: la prima riga non è il codice, e il codice non lo vedi più | test_si_vedono_il_codice_e_gli_header |
2 · I treni che dormono
In italiano. Chiedo i treni, con il filtro stato uguale a in deposito. Lo spazio dell'indirizzo si scrive %20.
curl "$BASE_URL/treni?stato=in%20deposito"Le trappole.
| Il comando sbagliato | Cosa succede | Il test rosso |
|---|---|---|
curl "$BASE_URL/treni?stato=in deposito" | curl: (3) URL rejected: Malformed input to a URL function: lo spazio rende l'indirizzo non valido, la richiesta non parte e non stampa niente | test_arriva_una_lista, test_solo_i_treni_in_deposito |
curl "$BASE_URL/treni?tipo=tram" | Il filtro è un altro: arrivano T05 e T28, e la risposta ha l'aria giusta (è una lista di treni) | test_solo_i_treni_in_deposito |
La seconda è la più subdola: nessun errore, una lista ordinata di treni. Solo guardando quali treni ci sono si vede che è sbagliata.
3 · Un treno nuovo
In italiano. Mando una POST a /treni, dico che il corpo è JSON, e nel corpo scrivo il treno. Con -i vedo il 201.
curl -i -X POST "$BASE_URL/treni" \
-H "Content-Type: application/json" \
-d '{"codice": "M22", "tipo": "metro", "vagoni": 4}'Passo per passo.
| Pezzo | Cosa fa |
|---|---|
-i | Mostra la riga HTTP/1.1 201 Created |
-X POST | Il verbo (curl lo capirebbe già da -d, ma scriverlo rende chiaro cosa vuoi) |
"$BASE_URL/treni" | Il server, e il percorso della collezione dei treni |
-H "Content-Type: application/json" | «Il corpo è JSON» |
-d '…' | Il corpo, tra virgolette semplici |
Le trappole.
| Il comando sbagliato | Cosa succede | Il test rosso |
|---|---|---|
-d '…' senza -H | curl manda il corpo come un modulo: la centrale risponde 422, il M22 non viene creato | test_la_centrale_risponde_201, test_il_m22_adesso_c_e |
senza -i | Il treno viene creato, ma il codice non si vede: il test non trova la riga 201 | test_la_centrale_risponde_201 |
4 · Un treno cambia posto
In italiano. Mando una PUT a /treni/M20 con il treno intero, com'è adesso: metro, 4 vagoni, in servizio, a Via Variabile.
curl -i -X PUT "$BASE_URL/treni/M20" \
-H "Content-Type: application/json" \
-d '{"tipo": "metro", "vagoni": 4, "stato": "in servizio", "stazione": "Via Variabile"}'Qui -X PUT serve: con -d da solo curl farebbe una POST.
Le trappole.
| Il comando sbagliato | Cosa succede | Il test rosso |
|---|---|---|
-d '{"stazione": "Via Variabile"}' | La PUT sostituisce il treno intero: mancano tipo e vagoni, la centrale risponde 422 e il M20 resta com'era | test_la_centrale_risponde_200, test_il_m20_e_in_servizio_a_via_variabile |
5 · Un treno va in demolizione
In italiano. Dico alla centrale «togli il M16», con il verbo DELETE, e guardo la riga del codice.
curl -i -X DELETE "$BASE_URL/treni/M16"Le trappole.
| Il comando sbagliato | Cosa succede | Il test rosso |
|---|---|---|
curl -i "$BASE_URL/treni/M16" | Senza -X DELETE è una GET: la centrale risponde 200 con la scheda del M16, e il treno resta | test_la_centrale_risponde_204, test_il_m16_non_c_e_piu, test_gli_altri_treni_sono_al_loro_posto |
Il comando sbagliato sembra funzionare: stampa una risposta, nessun errore. Controllare il codice (-i) e lo stato dopo è l'unico modo di accorgersene.
6 · Chi sono
In italiano. Faccio una GET a /me e nell'header Authorization metto la parola Bearer seguita dal biglietto, che sta nella variabile BIGLIETTO.
curl -s "$BASE_URL/me" -H "Authorization: Bearer $BIGLIETTO"Passo per passo.
| Pezzo | Cosa fa |
|---|---|
-s | Niente barra di avanzamento: la risposta è solo il JSON |
"$BASE_URL/me" | La rotta che dice chi sei |
-H "Authorization: Bearer $BIGLIETTO" | L'header. Le virgolette doppie lasciano che la shell sostituisca $BIGLIETTO; le semplici lo scriverebbero così com'è, e il biglietto non arriverebbe mai |
Le trappole.
| Il comando sbagliato | Cosa succede | Il test rosso |
|---|---|---|
-H "Authorization: $BIGLIETTO" | Manca la parola Bearer: il biglietto c'è, ma la centrale non lo riconosce e risponde 401 | test_la_centrale_ti_riconosce |
-H "Authorization: Bearer eyJ-copiato-ieri" | Il biglietto scritto per esteso: oggi non vale più (scade, e a ogni riavvio del server la chiave cambia). Il test ne mette uno suo in $BIGLIETTO, e tu non lo usi | test_la_centrale_ti_riconosce, test_il_biglietto_non_e_scritto_per_esteso |
Postman, senza trappole
Per Postman nessun test: la soluzione è la tabella «cosa fai, cosa vedi» della palestra. I due errori che si vedono di più:
- Body su Text invece di JSON:
422, come curl senza-H. - Bearer Token vuoto, o
{{biglietto}}ancora rosso:401. La variabile si riempie con lo script post-response del login, e va rifatto a ogni riavvio del server.