Playground (pasek boczny > Playground) pozwala uruchamiać rzeczywiste żądania API przy użyciu Twojego prawdziwego klucza bez pisania kodu. To najszybszy sposób na przetestowanie nowej witryny docelowej, debugowanie problematycznej odpowiedzi lub bezpośrednie porównanie silników Auto, Single, Proxy i Browser.

Otwórz go pod adresem foura.ai/dashboard#playground.

Jak to działa

Jeden formularz. Cztery silniki. Rzeczywisty ruch.

  • Auto: inteligentne pobieranie. Podajesz URL oraz regułę validate, a FourA wybiera najtańszą działającą ścieżkę.
  • Single: bezpośrednie pobieranie HTTP o realistycznej charakterystyce sieciowej przypominającej przeglądarkę
  • Proxy: zarządzane pobieranie przez rotacyjne proxy, z opcją ograniczenia do krajów widocznych dla celu
  • Browser: otwiera URL w instancji przeglądarki Chrome dla stron renderowanych w JS

Żądania są wykonywane przy użyciu klucza API wybranego na górze strony. Użycie wlicza się do limitu tego klucza dokładnie tak samo, jak wywołanie produkcyjne, więc uważaj, aby nie wyczerpać planu podczas testów.

Wybór klucza

Menu rozwijane kluczy API zawiera listę wszystkich aktywnych kluczy, których możesz użyć: Twoje własne w sekcji My Keys, a następnie po jednej grupie dla każdej organizacji, do której należysz. Każdy członek może użyć klucza organizacji, a wykonane nim żądanie obciąża plan właściciela organizacji. Wybierz ten, z którego ma zostać rozliczone żądanie. Jeśli nie masz jeszcze aktywnych kluczy, monit na stronie przekieruje Cię do sekcji API Keys, aby go utworzyć.

Wybór trybu

Górny wiersz Mode przełącza między trybem Auto a silnikami ręcznymi. Po wybraniu Auto formularz przełącza się na uproszczony interfejs Auto (URL, validate oraz kilka opcji). Zawsze widoczne są oba wiersze: Mode: Auto oraz Endpoint: Single, Proxy, Browser. Wybór jednej opcji odznacza drugą. Przełączanie endpointów zmienia widoczne pola oraz silnik obsługujący żądanie. Bieżący wybór jest zachowywany po odświeżeniu strony.

Mode Kiedy używać
Auto Nowy cel lub witryna o mieszanych zabezpieczeniach. Auto wybiera najtańszą ścieżkę i zapamiętuje działające rozwiązanie.
Single Szybkie pobieranie HTTP. Najlepszy pierwszy wybór dla znanego hosta.
Proxy To samo pobieranie z automatyczną rotacją proxy. Ustaw exitCountries, gdy potrzebujesz kraju widocznego dla celu.
Browser Ładuje stronę w instancji przeglądarki Chrome. Używaj, gdy dane pojawiają się dopiero po wykonaniu JavaScriptu.

Tworzenie żądania

Wiersz URL

Górny wiersz zawiera metodę HTTP (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), docelowy URL oraz przycisk Send. Single, Proxy i Auto obsługują każdą metodę. Browser ignoruje metodę (Chrome zawsze wysyła GET przy nawigacji) oraz body.

Zakładki żądania

Poniżej wiersza URL znajduje się pięć zakładek umożliwiających uzupełnienie reszty parametrów:

Karta Za co odpowiada
UI Pola formularza dla timeoutów, przekierowań, flag, proxy, opcji specyficznych dla przeglądarki oraz reguł walidacji
Body Dowolne body dla żądań POST / PUT / PATCH
Headers Niestandardowe nagłówki żądania jako pary klucz-wartość
Cookies Magazyn cookie (cookie jar) przechowywany dla każdego hosta w tej przeglądarce. Use jar dołącza pasujące pliki cookie do żądania, a Save response cookies zapisuje te ustawione przez odpowiedź. Obie opcje są domyślnie włączone, a karta wyświetla podgląd tego, co wyśle żądanie
Raw Dokładny payload JSON, który zostanie wysłany, w formie podglądu tylko do odczytu z opcją Copy JSON oraz komendą curl do odtworzenia poniżej

Wszystkie zmiany wprowadzone w UI / Body / Headers / Cookies są odzwierciedlane w Raw. Nie można edytować bezpośrednio w Raw: modyfikuj żądanie na pozostałych kartach. Czerwona kropka pojawia się na każdej karcie lub zwijanej sekcji, która zawiera wartość różniącą się od wartości domyślnych silnika, co pozwala od razu zauważyć wprowadzone modyfikacje.

Sekcje panelu UI

Karta UI grupuje ustawienia w zwijane sekcje. Puste pola przyjmują domyślne wartości ze schematu silnika. Sekcje, które nie mają zastosowania w bieżącym trybie (Mode), są ukryte.

  • Limity czasu (Timeouts): timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec. Browser oraz Auto udostepniaja tylko timeout_ms (w Auto jest to calkowity budzet).
  • Przekierowania: przelacz i ustaw followRedirects (0-20). Single i Proxy. Browser podaza za przekierowaniami samodzielnie.
  • Flagi: unblocker dla Single, Proxy i Browser (unblocker w Browser wykonuje weryfikacje wymagane przez strone); tryJsonData i returnBuffer dla Single i Proxy. Auto zamiast tego udostepnia forceProxy oraz returnSession.
  • Proxy: wybierz konkretny identyfikator proxy ID dla Single lub Browser, albo ustaw maxTries, zewnetrzny limit czasu Proxy, exitCountries, exitClass oraz ignoreProxies dla silnika Proxy. Auto udostepnia rowniez ignoreProxies i exitClass. Pole wyboru exitClass ma trzy stany: brak ustawienia nie wysyla zadnego pola, standard wskazuje pule standardowa, a premium pozwala na eskalacje requestu do wezla wyjsciowego premium, gdy pula standardowa ma problemy. Brak wyboru i standard pozostaja przy puli standardowej; pomyslny request wskazujacy klase zwraca w odpowiedzi exitClass. Opcja premium wymaga planu obejmujacego wezly premium: zobacz exitClass.
  • Profil przegladarki: trzy kaskadowe listy rozwijane, os, browser oraz version, prezentujace konfiguracje obslugiwane przez FourA. Pojawiaja sie w trybach Single i Proxy. Pozostaw je puste, aby uzyc najnowszego Chrome. Kazde pole wyboru zaweza opcje w pozostalych dwoch, dzieki czemu nieprawidlowe kombinacje nigdy sie nie pojawia. Ta sekcja wymaga wlaczonego unblocker: gdy jest wylaczony, naglowki przegladarki nie sa wysylane, profil zostalby zastosowany tylko czesciowo, a API odrzuci request.
  • Browser: opcje wylacznie dla przegladarki, takie jak checkStatus i checkText.
  • Walidacja: status accept i status fail przyjmuja kody statusu oddzielone przecinkami (validate.status), a body accept i body fail przyjmuja fragmenty tekstu z wariantami oddzielonymi znakiem | (validate.data). Dostepne dla Single, Proxy i Auto. Browser korzysta zamiast tego z checkStatus i checkText. Formularz nie zawiera pola dla regul naglowkow (validate.headers).

Gdy wykonanie zwroci dzialajace proxy, na koncu karty interfejsu pojawi sie sekcja Working proxies. Zawiera do 20 identyfikatorow proxy ID, od najnowszych, wraz z krajem wyjsciowym i czasem. Opcja use wstawia dane proxy do pola proxy w Single lub Browser (silnik Proxy sam dobiera wlasne), a × usuwa je z listy.

Zakres kraju wyjsciowego (Tryb Proxy)

Pole exitCountries w obiekcie Proxy przyjmuje rozdzielaną przecinkami listę dwuliterowych kodów krajów widocznych dla celu (CZ, GB). Wartości są przycinane z białych znaków, zamieniane na wielkie litery i deduplikowane podczas wysyłania. Wybór ze standardowej puli działa na zasadzie ścisłej białej listy: proxy o nieznanych lokalizacjach wyjściowych są wykluczane, a pula nigdy nie przełącza się awaryjnie na inny kraj. Wyjście premium również przestrzega tej listy. Gdy parametr exitClass ma wartość premium, wyjście premium następuje z jednego z podanych krajów, a kraj, dla którego w standardowej puli nie ma zasobów, kieruje ruch do tamtejszych wyjść premium. Bez premium pula bez pasujących zasobów zwraca code: "no_eligible_proxy" z żądanym zakresem powtórzonym w details.exitCountries. Zachowaj ten zakres i ponów próbę później.

Gdy wywołanie proxy zakończy się powodzeniem w ramach zdefiniowanego zakresu, pasek odpowiedzi wyświetla exit <CODE> obok identyfikatora proxy, co pozwala sprawdzić, czy zwrócony kraj jest zgodny z żądanym.

Lokalizacja wyjściowa (tryb proxy)

Grupa Exit location w obiekcie Proxy określa miejsce wyjścia premium: region, miasto, sieć, urządzenie oraz czas utrzymywania adresu. Listy regionów, miast i sieci są wypełniane, gdy parametr exitCountries wskazuje dokładnie jeden kraj. Ustaw exitClass na premium, ponieważ którakolwiek z tych opcji kieruje żądanie wyłącznie przez wyjścia premium. Identyfikator proxy w odpowiedzi zachowuje tę lokalizację, więc przekazanie go do Single lub Browser to wszystko, czego oba tryby potrzebują. Zobacz Exit location.

Resetowanie paska narzędzi

Przycisk Reset na pasku narzędzi (obok History i Saved) przywraca stan początkowy środowiska testowego. Ponieważ jest to operacja destrukcyjna, otwiera okno dialogowe z potwierdzeniem, które dokładnie wymienia usuwane elementy: wszystkie karty żądań, zapisane pliki cookie w magazynie, przekazane proxy oraz bieżącą odpowiedź. Zapisane szablony i wybrany klucz API zostają zachowane. Kliknij Reset everything, aby potwierdzić; każda inna akcja anuluje operację.

Wysyłanie i anulowanie

Kliknij Send, aby wysłać żądanie. Prawa kolumna przełącza się w stan ładowania ze wskaźnikiem postępu i przyciskiem Cancel, gdy wywołanie jest w toku. Kliknij Cancel (lub dotknij przycisku ponownie na urządzeniu mobilnym), aby przerwać. Anulowane żądanie przywraca domyślny stan zastępczy z komunikatem "Request canceled." zamiast renderowania błędu.

Karta odpowiedzi przełącza się na widok wyniku w momencie zakończenia (lub niepowodzenia) żądania. Na telefonie lub w oknie na tyle wąskim, że odpowiedź trafia pod formularz, strona automatycznie przewija widok do karty odpowiedzi, gdy ta pojawi się niżej na ekranie. Uruchomienia automatyczne mogą trwać dłużej niż w przypadku silników manualnych, ponieważ procedura może pokonywać kilka kolejnych poziomów na nierozpoznanym celu.

Odczytywanie odpowiedzi

Kolumna odpowiedzi odzwierciedla układ żądania z własnymi kartami:

Karta Co zawiera
Body Sparsowane body. Przełącza się między widokami JSON, HTML i Text w zależności od zwróconych danych.
Headers Nagłówki response, po jednym w wierszu.
Cookies Pliki cookie zwrócone przez cel, w widoku sparsowanym (pogrupowane według hosta) oraz surowym (tekst Set-Cookie). Widok sparsowany oznacza pliki cookie typu host-only plakietką HO; pliki cookie dla domeny pozostają bez oznaczenia.
Raw Pełna koperta JSON zwrócona przez API.

Pasek narzędzi response zawiera opcje Kopiuj i Pobierz dla całej odpowiedzi oraz Znajdź w odpowiedzi (Ctrl+K lub Cmd+K) do przeszukiwania otwartej karty, z obsługą Enter i Shift+Enter do przechodzenia między wynikami. Karty Body, Headers i Cookies mają także własne przyciski Kopiuj i Pobierz działające tylko dla danej karty.

Pasek metadanych nad kartami wyświetla nadrzędny status HTTP, łączny czas, ID proxy obsługującego wywołanie oraz (w przypadku wywołania Proxy z określonym zakresem) dwuliterowy kod exit <CODE>. Pasek pokazuje również rozmiar odpowiedzi i, jeśli API je zwraca, kredyty zużyte przez request. W przypadku uruchomień Auto poziom wykonania oraz liczba prób znajdują się w zdaniu pod paskiem.

Czego wymagało wywołanie

Zdanie pod paskiem metadanych opisuje słownie sposób pobrania strony. W przypadku uruchomienia Auto wskazuje poziom wykonania (sesja, którą FourA już posiadało dla danego hosta, zwykły request, rotujące proxy, prawdziwa przeglądarka lub najpierw przeglądarka, a potem tańsze odtworzenie), informację o rozwiązaniu challenge'a, liczbę prób oraz koszt. Gdy request miał ustawioną opcję exitClass, informuje również, czy żądanie obsłużył węzeł wyjściowy premium, czy standardowa pula.

Gdy wywołanie zostało odrzucone przez jeden z limitów planu, zdanie informuje o tym na początku: "Zatrzymano przez Twój plan, nie przez stronę", wskazując konkretny limit (wyczerpane dzisiejsze zapytania przeglądarkowe, zbyt wiele aktywnych zapytań, zużyte kredyty w bieżącym okresie itp.) wraz z linkiem do sekcji Użycie i limity. Komunikat ten bazuje na kodzie X-FourA-Limit zwróconym przez API, dzięki czemu w razie niepowodzenia na trudnej stronie wiadomo od razu, czy zablokowała ją witryna, czy ograniczenia planu.

Przenoszenie wartości między uruchomieniami

Po każdym uruchomieniu, które zwróciło dane sesji wielokrotnego użytku, mały element sterujący Przenieś na pasku narzędzi response pokazuje dostępne opcje:

  • Uruchomienia Auto wykonane z parametrem returnSession oferują wartości userAgent i proxy sesji. Pliki cookie sesji pojawiają się na karcie Cookies odpowiedzi i trafiają do bazy cookie jar, gdy włączona jest opcja Zapisuj pliki cookie z odpowiedzi.
  • Uruchomienia Browser oferują nagłówek userAgent odpowiedzi oraz ID proxy, jeśli zostało użyte.
  • Uruchomienia Proxy oferują zwrócone ID proxy oraz profil przeglądarki, gdy rotacja wybrała profil inny niż żądany.

Kliknij Przenieś i wskaż jednym kliknięciem, gdzie zastosować każdą wartość: userAgent staje się nagłówkiem User-Agent w trybie Single lub Proxy, a ID proxy trafia do pola proxy w trybie Single lub Browser. Pola, które otrzymały przeniesioną wartość, są oznaczane czerwoną kropką modyfikacji, co pozwala łatwo zobaczyć wprowadzone zmiany.

Przeniesiony browser profile wypełnia trzy pola wyboru: os, browser oraz version i włącza unblocker, czyli dokładnie tak samo, jak przy ręcznym wyborze profilu. Opcja ta jest dostępna dopiero po załadowaniu katalogu profili, ponieważ formularz składa się z trzech pól wyboru, a nie pojedynczego pola id.

Profil to jedyna wartość wskazująca, że request, który zadziałał, różnił się od wpisanego: Proxy zgłasza profile tylko wtedy, gdy nastąpiło przejście na inną rodzinę przeglądarek niż żądana. Ponowne uruchomienie bez niego odtworzy wersję, która zakończyła się błędem. Zobacz Dlaczego request Proxy wyczerpał próby.

Rozwiń na pełny ekran

Ikona rozwijania na pasku narzędzi odpowiedzi przenosi kartę response z widoku dzielonego do nakładki pełnoekranowej. Używaj jej przy głębokich drzewach JSON, długich zrzutach Set-Cookie lub szerokich treściach HTML, gdzie kolumna o połowie szerokości staje się zbyt ciasna. Sama strona blokuje przewijanie, gdy nakładka jest otwarta. Kliknij ikonę ponownie (lub naciśnij Escape), aby ją zwinąć.

Odtwarzanie za pomocą curl

W zakładce Raw danego requesta, pod kodem JSON, blok curl wyświetla dokładny odpowiednik budowanego requesta w wierszu poleceń wraz z przyciskiem Copy curl. Skopiuj go, aby odtworzyć request w terminalu, udostępnić go współpracownikowi lub wkleić do zgłoszenia błędu.

W przypadku kluczy z możliwością podglądu przycisk Reveal key obok fragmentu kodu wstawia rzeczywisty klucz w formie jawnego tekstu bezpośrednio do polecenia curl, umożliwiając natychmiastowe skopiowanie i uruchomienie. Kliknij ponownie, aby go ukryć. Starsze klucze (utworzone przed wprowadzeniem funkcji podglądu) zachowują symbol zastępczy PASTE_PLAINTEXT_FOR_<key-name>; wygeneruj klucz ponownie na stronie API Keys, aby włączyć opcję podglądu.

Każde odsłonięcie klucza jest rejestrowane w dzienniku audytu na serwerze, a jawny klucz pozostaje w pamięci wyłącznie podczas bieżącej sesji strony.

Zapisywanie presetów

Jeśli konfigurujesz ten sam cel wielokrotnie, zapisz go. Kliknij Save w rzędzie zakładek requesta, aby zachować bieżącą konfigurację jako nazwany preset.

Otwórz Saved na pasku narzędzi, aby przejrzeć swoje presety. Kliknij Load, aby wypełnić formularz, lub Delete, aby go usunąć.

Request otwarty z karty DevTools rozszerzenia FourA Chrome ładuje się z wybranym kluczem rozszerzenia, o ile klucz ten znajduje się na Twoim koncie, o czym informuje strona. W przeciwnym razie pojawi się prośba o wybór klucza. Odtwarzany request, który nie definiuje unblocker, uruchamia się z tą opcją włączoną, tak jak działa API.

Pole presetu Co przechowuje
Name Krótka etykieta (do 100 znaków)
Description Opcjonalne notatki (do 500 znaków)
Endpoint Silnik, dla którego przeznaczony jest preset (auto / single / proxy / browser)
Config Pełny payload requesta, w tym pola UI, nagłówki, pliki cookie i treść

Presety są przypisane do Twojego konta użytkownika i nie są udostępniane członkom zespołu.

Odtwarzanie z historii

Każdy uruchomiony request jest rejestrowany. Otwórz History na pasku narzędzi, aby zobaczyć ostatnie 20 wywołań, posortowanych od najnowszych.

Kazdy wiersz pokazuje endpoint, docelowy URL, status oraz czas. Kliknij Replay w dowolnym wierszu, aby ponownie zaladowac to request do formularza, a nastepnie Send, aby uruchomic je ponownie.

Historia jest automatycznie ograniczona do Twojego konta: widzisz tylko wlasne wywolania.

Otwieranie z poziomu Activity

Okno szczegolow Activity Log zawiera przycisk Open in Playground. Kliknij go, a Playground zaladuje zarowno zarchiwizowane request, jak i zarchiwizowana response. Formularz wypelnia sie zapisanym payloadem, a karta response pokazuje dane zwrocone przez API w tamtym momencie z oznaczeniem "archived" na pasku proxy meta ("archived

W tym miejscu mozesz zmienic parametr i kliknac Send, aby wykonac nowe request do aktywnego API, albo po prostu przejrzec zarchiwizowany payload bez ponownego uruchamiania. Dane payload sa przechowywane przez 24 godziny, wiec starsze wiersze Activity nie beda mialy mozliwosci ponownego zaladowania response.

Wskazowki

  • Zanim zaczniesz pisac kod dla nowego celu, zacznij od Playground. Z wlaczonym trybem Auto w ciagu kilku sekund dowiesz sie, czy wystarczy zwykly fetch, czy strona wymusza rozwiazanie przez przegladarke.
  • W przypadku celow z blokada regionalna wykonaj jedno wywolanie Proxy z ustawionym exitCountries, a nastepnie przekaz zwrocony proxy ID do wywolania Browser, aby renderowanie JavaScript odbylo sie przez ten sam wezel wyjsciowy.
  • Zapisz preset dla kazdego celu, ktory regularnie scrapujesz. Odtworzenie zapisanego presetu wymaga jednego klikniecia; odtwarzanie request z pamieci zajmuje wiecej czasu.
  • Uzyj karty Cookies do debugowania scrapowania opartego na sesjach. Widok surowych naglowkow Set-Cookie pokazuje dokladnie to, co wyslal cel.
  • Gdy cel odrzuca polaczenie, wyprobuj inna pozycje na liscie wyboru profilu Browser przed siegnieciem po ciezszy silnik. Zmiana prezentowanej przegladarki jest bezplatna; pelne renderowanie w przegladarce generuje koszty.
  • Wywolania w Playground sa rozliczane w ramach wybranego klucza. Uzyj dedykowanego klucza z niskim limitem do testow, jesli chcesz zachowac porzadek w zuzyciu produkcyjnym.
Aktualizacja: 11 listopada 2026