# Playground

> URL: https://foura.ai/pl/docs/dashboard/playground
> Updated: 2026-11-11
> Index: https://foura.ai/llms.txt

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](https://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](https://foura.ai/docs/api/endpoints#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](https://foura.ai/docs/api/endpoints#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](https://foura.ai/docs/dashboard/quota). 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](https://foura.ai/docs/troubleshooting/proxy-attempt-report).

### 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](https://foura.ai/docs/dashboard/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 <time> [, truncated] [, via <proxy>]").

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.

## Powiazane

- [API Endpoints](https://foura.ai/docs/api/endpoints): Pelna dokumentacja parametrow dla wszystkich czterech silnikow, w tym `exitCountries` oraz pol profilu przegladarki
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Jak dziala Auto pod maska
- [Choosing the Right Endpoint](https://foura.ai/docs/guides/choosing-task-type): Kiedy wybrac Auto, Single, Proxy czy Browser
- [API Keys](https://foura.ai/docs/dashboard/api-keys): Zarzadzaj kluczami uzywanymi do uwierzytelniania zadan w Playground
- [Activity Log](https://foura.ai/docs/dashboard/activity-log): Otworz wczesniejsze request bezposrednio w Playground
- [Dashboard Overview](https://foura.ai/docs/dashboard/overview): Wszystkie sekcje paska bocznego
