Konstruktor żądań API
Dlaczego używać konstruktora żądań API?
Testowanie API REST zwykle wymaga zainstalowania Postmana, Insomni lub pisania poleceń curl. Nasz klient HTTP oparty na przeglądarce nie wymaga instalacji — wystarczy otworzyć i zacząć wysyłać żądania. Obsługuje wszystkie metody HTTP, niestandardowe nagłówki, treść JSON i parametry zapytania, co czyni go idealnym do szybkich testów API, eksploracji publicznych API i debugowania integracji.
Wszystkie metody HTTP
Obsługuje GET, POST, PUT, PATCH, DELETE z niestandardowymi nagłówkami i treścią JSON/formularza
Sformatowana odpowiedź
Treść odpowiedzi jest automatycznie wyświetlana z wcięciami, kodem statusu i czasem odpowiedzi
Gotowe do użycia
Nie wymaga instalacji — działa w pełni w przeglądarce bez konta ani wtyczki
Jak wysłać żądanie API
Wpisz URL i metodę
Wpisz URL punktu końcowego API i wybierz metodę HTTP (GET, POST, itp.)
Dodaj nagłówki i treść
Przejdź do karty Nagłówki, aby dodać Authorization, Content-Type i inne. Użyj Treść dla danych POST/PUT.
Wyślij i sprawdź
Kliknij Wyślij, aby wykonać żądanie. Treść odpowiedzi, kod statusu i czas pojawią się poniżej.
Przypadki użycia konstruktora żądań API
Debugowanie API
Testuj poszczególne punkty końcowe z niestandardowymi nagłówkami i treściami do debugowania problemów uwierzytelniania i danych
Testowanie tokenów uwierzytelniania
Testuj schematy Bearer, Basic Auth i klucza API bez pisania kodu
Eksploracja API
Eksploruj publiczne API (GitHub, OpenWeather, JSONPlaceholder) i rozumiej ich odpowiedzi
Reprodukcja błędów
Reprodukuj i dokumentuj błędy API z dokładnymi szczegółami żądania/odpowiedzi dla raportów błędów
Najlepsze praktyki testowania API
✓ Zawsze ustawiaj Content-Type
Wysyłając treść JSON, zawsze dołączaj Content-Type: application/json. Bez tego wiele API odrzuci lub błędnie zinterpretuje żądanie.
✓ Zrozum ograniczenia CORS
Przeglądarki blokują żądania cross-origin bez odpowiednich nagłówków CORS. Jeśli żądanie nie powiedzie się w przeglądarce, użyj curl lub proxy po stronie serwera.
✓ Nigdy nie koduj na stałe kluczy API
Używaj zmiennych środowiskowych w kodzie produkcyjnym. Konstruktor żądań jest tylko do testów — nie udostępniaj zrzutów ekranu z prawdziwymi kluczami API.
✓ Sprawdzaj kody statusu HTTP
200=OK, 201=Utworzono, 400=Złe żądanie, 401=Nieautoryzowany, 403=Zabroniony, 404=Nie znaleziono, 500=Błąd serwera.
❓ Często zadawane pytania
Dlaczego moje żądanie cross-origin nie powiedzie się?
Przeglądarki wymuszają ograniczenia CORS (Cross-Origin Resource Sharing). Jeśli docelowe API nie zawiera nagłówków Access-Control-Allow-Origin, przeglądarka blokuje żądanie. To nie błąd — użyj curl lub proxy backendowego dla API bez obsługi CORS.
Czy mogę wysyłać żądania multipart/form-data?
Aktualny konstruktor obsługuje treści JSON i zwykły tekst. W przypadku wieloczęściowych danych formularza (przesyłanie plików) użyj natywnego przesyłania formularzy przeglądarki lub dedykowanego narzędzia, takiego jak Postman.
Czy to zamiennik Postmana?
Do szybkich testów i eksploracji — tak. W przypadku współpracy zespołowej, zapisanych kolekcji, środowisk i zautomatyzowanych testów Postman lub Bruno oferują więcej funkcji. To narzędzie wyróżnia się natychmiastowymi testami API bez konfiguracji.
Jaka jest różnica między PUT a PATCH?
PUT zastępuje cały zasób treścią żądania. PATCH stosuje częściową aktualizację — tylko pola zawarte w treści są zmieniane. Większość API REST używa PATCH do aktualizacji, aby nie nadpisywać niemodyfikowanych pól.