L'API navigabile e i codici di stato
Testare correttamente gli endpoint nel browser
L'API navigabile e i codici di stato è una lezione Django Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Django Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Django Academy include 4 lezioni in totale.
Testare nel browser
La API consultabile di DRF esegue il rendering di qualsiasi endpoint come pagina web interattiva, così può esplorare e testare la Sua API senza strumenti aggiuntivi. 🌐
Come decide
DRF usa la negoziazione dei contenuti: i browser richiedono HTML e ricevono la pagina intuitiva, mentre il codice che richiede JSON riceve invece JSON puro.
Moduli già pronti
Per gli endpoint di scrittura, la API consultabile mostra persino un modulo, che Le permette di inviare dati di test con un clic invece di creare comandi curl.
Forzare JSON in qualsiasi momento
Aggiunga ?format=json a qualsiasi URL per ignorare la pagina HTML e visualizzare l'esatto JSON che riceverebbe un client reale.
GET /api/books/?format=jsonI codici di stato sono importanti
Ogni risposta API contiene un codice di stato HTTP che comunica al client cosa è successo, in modo molto più affidabile della lettura del testo del corpo.
200 e 201
200 indica una lettura riuscita, mentre 201 Created segnala che una richiesta POST ha effettivamente creato una nuova risorsa: una distinzione piccola, ma importante.
Costanti leggibili
Invece di usare numeri magici, DRF mette a disposizione costanti con nome in status, così il codice è più chiaro ed evita errori di battitura come 20 invece di 200.
from rest_framework import status
status.HTTP_201_CREATEDErrori del client: 400 e 404
L'intervallo 4xx indica un problema nella richiesta: 400 significa che i dati immessi non sono validi, mentre 404 significa semplicemente che la risorsa non è stata trovata.
Response(serializer.errors, status=400)Errori del server: 500
Un 500 significa che il Suo codice si è arrestato in modo anomalo, non che il problema sia del client. Questi codici indicano bug da correggere, non errori commessi dal chiamante.
Associare il codice al risultato
Le API ben progettate sono prevedibili: restituiscono 201 durante la creazione, 400 per dati non validi e 404 quando una risorsa non esiste. I codici di stato corretti fanno sì che i client si fidino della Sua API.
API consultabile e codici di stato
Insieme, la API consultabile e i codici di stato chiari rendono gli endpoint DRF facili da testare manualmente e da utilizzare per i client.
Verifica rapida
Quale codice di stato è più adatto a una richiesta POST riuscita che crea un record?
Riepilogo: testare e rispondere
Ha conosciuto la API consultabile per i test pratici e ha imparato a restituire codici di stato appropriati, come 200, 201, 400 e 404. ✅
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «L'API navigabile e i codici di stato» è gratuita?
Sì — il testo completo di «L'API navigabile e i codici di stato» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Django Academy, passa a CoddyKit PRO. Il corso Django Academy include 4 lezioni in totale.
Cosa imparerò in «L'API navigabile e i codici di stato»?
Testare correttamente gli endpoint nel browser Eserciti Django Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Django Academy?
Non è richiesta alcuna esperienza precedente. Django Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.
Quanto tempo richiede la lezione «L'API navigabile e i codici di stato»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Django Academy?
Sì. Ogni lezione Django Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Installare e configurare DRF
- Serializer: dal modello a JSON
- APIView e @api_view per le funzioni
- L'API navigabile e i codici di stato