Przeglądalne API i kody statusu
Prawidłowe testowanie endpointów w przeglądarce
Przeglądalne API i kody statusu to bezpłatna lekcja Django Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Django Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Django Academy zawiera 4 lekcji w sumie.
Testowanie w przeglądarce
Przeglądalne API DRF renderuje każdy endpoint jako interaktywną stronę internetową, dzięki czemu można przeglądać i testować API bez dodatkowych narzędzi. 🌐
Jak podejmuje decyzję
DRF korzysta z negocjacji zawartości: przeglądarki żądają HTML i otrzymują przyjazną stronę, natomiast kod żądający JSON otrzymuje surowy JSON.
Formularze bez wysiłku
W przypadku endpointów zapisujących dane przeglądalne API wyświetla nawet formularz, dzięki czemu można jednym kliknięciem wysłać testowe dane metodą POST zamiast tworzyć polecenia curl.
Wymuszanie JSON w dowolnym momencie
Dodaj ?format=json do dowolnego adresu URL, aby pominąć stronę HTML i zobaczyć dokładny JSON, który otrzymałby rzeczywisty klient.
GET /api/books/?format=jsonKody statusu mają znaczenie
Każda odpowiedź API zawiera HTTP-owy kod statusu, który informuje klienta, co się stało — znacznie bardziej niezawodnie niż treść odpowiedzi.
200 i 201
200 oznacza pomyślny odczyt, natomiast 201 Created informuje, że żądanie POST rzeczywiście utworzyło nowy zasób. To niewielka, ale ważna różnica.
Czytelne stałe
Zamiast magicznych liczb DRF udostępnia nazwane stałe w status, dzięki czemu kod jest czytelny i nie dochodzi w nim do pomyłek, takich jak 20 zamiast 200.
from rest_framework import status
status.HTTP_201_CREATEDBłędy klienta: 400 i 404
Zakres 4xx wskazuje na problem z żądaniem: 400 oznacza nieprawidłowe dane wejściowe, które nie przeszły walidacji, a 404 — że zasób po prostu nie został znaleziony.
Response(serializer.errors, status=400)Błędy serwera: 500
500 oznacza, że doszło do awarii kodu, a nie klienta. Taki status sygnalizuje błąd, który należy naprawić, a nie problem spowodowany przez wywołującego.
Dopasuj kod do wyniku
Dobre API jest przewidywalne: zwraca 201 po utworzeniu zasobu, 400 dla nieprawidłowych danych wejściowych i 404, gdy zasobu brakuje. Prawidłowe kody statusu budują zaufanie klientów.
Przeglądalne API i statusy
Przeglądalne API oraz jasne kody statusu sprawiają, że endpointy DRF można łatwo testować ręcznie, a klientom łatwo z nich korzystać.
Szybkie sprawdzenie
Jaki kod statusu najlepiej pasuje do pomyślnego żądania POST, które tworzy rekord?
Podsumowanie: testowanie i odpowiadanie
Poznali Państwo przeglądalne API do praktycznego testowania oraz nauczyli się zwracać właściwe kody statusu, takie jak 200, 201, 400 i 404. ✅
Często zadawane pytania
Czy lekcja „Przeglądalne API i kody statusu” jest bezpłatna?
Tak — pełny tekst „Przeglądalne API i kody statusu” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Django Academy, przejdź na CoddyKit PRO. Kurs Django Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Przeglądalne API i kody statusu”?
Prawidłowe testowanie endpointów w przeglądarce Ćwiczysz Django Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Django Academy?
Nie wymagamy żadnego doświadczenia. Django Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Przeglądalne API i kody statusu”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Django Academy?
Tak. Każda lekcja Django Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Instalowanie i konfigurowanie DRF
- Serializery: model do JSON
- APIView i funkcja @api_view
- Przeglądalne API i kody statusu