Kody statusu HTTP

Co oferuje strona Kody statusu HTTP

Kody statusu HTTP to przeszukiwalna ściąga z kodami odpowiedzi z zakresu od 100 do 599. Pomaga podczas debugowania wywołań API, pisania dokumentacji, wyboru odpowiedzi dla nowego endpointu, czytania logów, analizy zachowania bramy oraz wyjaśniania awarii innemu programiście. Każdy wpis zawiera kod liczbowy, frazę opisową, kategorię i krótki opis tego, co dana odpowiedź zwykle oznacza. Filtr dopasowuje kody, nazwy, kategorie i opisy, więc możesz szukać dokładnych wartości, takich jak 404, szerokich grup, takich jak redirect, albo pojęć, takich jak cache, auth, proxy, timeout i walidacja.

Lista jest osadzona bezpośrednio na stronie, a nie pobierana z usługi, dzięki czemu działa szybko i jest dostępna nawet wtedy, gdy pracujesz offline lub debugujesz problemy z siecią. Kliknięcie wyniku kopiuje kod i frazę, co ułatwia wklejanie ich do komentarzy w zgłoszeniach, dokumentacji, testów lub notatek o endpointach.

Prywatny przepływ pracy w przeglądarce

Całe przetwarzanie odbywa się w Twojej przeglądarce za pomocą JavaScriptu po stronie klienta. Narzędzie nie wysyła na serwer fragmentów kodu, wartości konfiguracji, wygenerowanych danych, treści zapytań ani skopiowanych przykładów i nie wymaga konta. Model wyłącznie lokalny ma znaczenie w narzędziach dla programistów, ponieważ wklejane treści często wyglądają jak prawdziwe dane aplikacji: odpowiedzi API, logi, przykłady przypominające zmienne środowiskowe, zapytania do baz danych, znaczniki ze szkiców lub wartości skopiowane z sesji debugowania na produkcji. Lokalne przetwarzanie zmniejsza ryzyko i przyspiesza pracę, bo nie ma przesyłania danych przez sieć.

Interfejs jest celowo kompaktowy, aby można było wkleić dane wejściowe, dostosować opcje, sprawdzić wynik, skopiować go i wrócić do edytora. Wyniki nadal warto przejrzeć przed zatwierdzeniem w commicie, publicznym udostępnieniem lub użyciem w procesie produkcyjnym. Narzędzia w przeglądarce świetnie nadają się do szybkiej inspekcji i przygotowania, ale nie znają każdej konwencji projektu, reguły klasyfikacji danych ani wymogu walidacji specyficznego dla aplikacji.

Praktyczne wskazówki

Kody statusu są częścią kontraktu API, więc wybieraj je świadomie. Używaj odpowiedzi z rodziny 400, gdy klient może zmienić żądanie, z rodziny 500, gdy serwer nie zdołał zrealizować poprawnego żądania, a z rodziny 300, gdy klient powinien poszukać zasobu gdzie indziej. Błędy uwierzytelniania i autoryzacji są często mylone: 401 zwykle oznacza, że uwierzytelnienie jest wymagane lub nieprawidłowe, a 403 oznacza, że uwierzytelniony wywołujący nie ma uprawnień. Dokumentując API, połącz kod ze schematem treści odpowiedzi i wskazówkami dotyczącymi naprawy.