# Playground

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

Playground (странична лента > Playground) ви позволява да изпълнявате API заявки на живо с реалния си ключ, без да пишете код. Това е най-бързият начин да изпробвате нов целеви сайт, да дебъгнете труден отговор или да сравните Auto, Single, Proxy и Browser един до друг.

Отворете го на [foura.ai/dashboard#playground](https://foura.ai/dashboard#playground).

## Какво прави

Един формуляр. Четири енджина. Реален трафик.

- **Auto**: интелигентно извличане. Подавате URL плюс `validate` правило и FourA избира най-евтиния работещ път.
- **Single**: директно HTTP извличане с реалистични мрежови характеристики, наподобяващи браузър
- **Proxy**: управлявано извличане с ротация на проксита, с опция за ограничаване до държави, видими за целта
- **Browser**: отваря URL адреса в Chrome браузър инстанция за сайтове, рендерирани с JS

Заявките се изпълняват спрямо избрания от вас API ключ в горната част на страницата. Потреблението се отчита към квотата на този ключ точно както при продукционно повикване, така че внимавайте да не изчерпите плана си по време на тестове.

## Избор на ключ

Падащото меню за API ключове изброява всеки активен ключ, който можете да използвате: вашите собствени под **My Keys**, следвани от група за всяка организация, в която членувате. Всеки член може да използва ключ на организация, като заявките се отчитат към плана на собственика на организацията. Изберете този, към който искате да се таксува заявката. Ако все още нямате активни ключове, съобщение на екрана ви препраща към страницата **API Keys**, за да създадете такъв.

## Избор на режим

Най-горният ред **Mode** превключва между **Auto** и ръчните енджини. Когато е избран Auto, формулярът преминава към минималния Auto интерфейс (URL плюс `validate` плюс няколко настройки). И двата реда се показват винаги: **Mode:** Auto и **Endpoint:** **Single**, **Proxy**, **Browser**. Избирането на единия отменя избора на другия. Превключването на endpoint променя видимите полета и енджина, към който отива заявката. Текущият избор се запазва при презареждане на страницата.

| Mode | Кога да се използва |
|------|----------------|
| Auto | Нова цел или сайт със смесена защита. Auto избира най-евтиния път и запомня какво работи. |
| Single | Бързо HTTP извличане. Най-добрият първи избор за познат хост. |
| Proxy | Същото извличане с автоматична ротация на проксита. Задайте `exitCountries`, когато се нуждаете от определена видима за целта държава. |
| Browser | Зарежда страницата в Chrome браузър инстанция. Използвайте го, когато данните се появяват само след изпълнение на JavaScript. |

## Изграждане на заявката

### Ред за URL

Най-горният ред съдържа HTTP метода (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), целевия URL и бутона **Send**. Single, Proxy и Auto поддържат всеки метод. Browser игнорира метода (Chrome винаги изпраща GET при навигация) и тялото на заявката.

### Табове за заявката

Под реда за URL пет таба ви позволяват да попълните всичко останало:

| Раздел | Какво контролира |
|-----|------------------|
| UI | Полета на формуляра за timeouts, redirects, флагове, proxy, специфични за браузъра опции и правила за validate |
| Body | Свободен текст за body при POST / PUT / PATCH заявки |
| Headers | Персонализирани request headers като двойки ключ-стойност |
| Cookies | Cookie jar, поддържан за всеки хост в този браузър. **Use jar** прикачва съвпадащите бисквитки към заявката, а **Save response cookies** записва тези, върнати от отговора. И двете опции са включени по подразбиране, а разделът показва визуализация на това, което тази заявка ще изпрати |
| Raw | Точният JSON payload, който ще бъде изпратен, като визуализация само за четене с бутон **Copy JSON**, и командата за възпроизвеждане чрез curl под него |

Всяка промяна в UI / Body / Headers / Cookies се отразява в Raw. Не можете да въвеждате текст директно в Raw: променете заявката в другите раздели. Появява се червена точка върху всеки раздел или сгъваема секция, която съдържа стойност, различна от стойностите по подразбиране на двигателя, за да виждате с един поглед какво е персонализирано.

### Секции на UI панела

Разделът UI групира настройките в сгъваеми секции. Празните полета използват стойностите по подразбиране от схемата на двигателя. Секциите, които не са приложими за текущия Mode, са скрити.

- **Timeouts**: `timeout_ms`, `connect_timeout_ms`, `accept_timeout_ms`, `server_response_timeout_ms`, `dns_cache_timeout_sec`. Browser и Auto предоставят само `timeout_ms` (при Auto, общият бюджет).
- **Redirects**: включване и настройка на `followRedirects` (0-20). Single и Proxy. Browser следва пренасочванията самостоятелно.
- **Flags**: `unblocker` за Single, Proxy и Browser (`unblocker` при Browser завършва проверките, изисквани от страницата); `tryJsonData` и `returnBuffer` за Single и Proxy. Auto предоставя вместо това `forceProxy` и `returnSession`.
- **Proxy**: изберете конкретен proxy ID за Single или Browser, или задайте `maxTries`, външния timeout за Proxy, `exitCountries`, `exitClass` и `ignoreProxies` за Proxy енджина. Auto предоставя също `ignoreProxies` и `exitClass`. Падащото меню `exitClass` има три състояния: unset не изпраща никакво поле, `standard` избира стандартния пул, а `premium` позволява на заявката да ескалира до premium изход, когато стандартният пул се затруднява. Unset и `standard` остават в стандартния пул; успешна заявка, която посочва клас, получава обратно `exitClass`. Premium изисква план, включващ premium изходи: вижте [exitClass](https://foura.ai/docs/api/endpoints#exitclass).
- **Browser profile**: три каскадни падащи менюта, **os**, **browser** и **version**, изброяващи какво FourA всъщност може да представи. Те се показват в режим Single и Proxy. Оставете ги празни за най-новия Chrome. Всяко меню стеснява останалите две, така че комбинация без съвпадение никога не се появява. Разделът изисква включен `unblocker`: при изключен не се изпращат browser заглавки, профилът би се приложил само частично и API отхвърля заявката.
- **Browser**: опции само за browser като `checkStatus` и `checkText`.
- **Validate**: **status accept** и **status fail** приемат кодове за статус, разделени със запетая (`validate.status`), а **body accept** и **body fail** приемат поднизове с алтернативи, разделени с `|` (`validate.data`). Налично за Single, Proxy и Auto. Browser използва вместо това `checkStatus` и `checkText`. Формулярът няма поле за правила за header (`validate.headers`).

След като дадено изпълнение върне работещо proxy, в края на раздела на интерфейса се появява секция **Working proxies**. Тя изброява до 20 proxy ID, най-новите първо, всяко с държава на изхода и време. **use** поставя едно в полето `proxy` при Single или Browser (Proxy енджинът намира свое собствено), а **×** го премахва от списъка.

### Ограничаване на държавата на изхода (Proxy режим)

Полето **exitCountries** в Proxy приема разделен със запетаи списък от двубуквени кодове на държави, видими за целта (`CZ, GB`). Стойностите се изчистват от интервали, преобразуват се в главни букви и се дедупликират при изпращане. Изборът от стандартния пул е стриктен списък с разрешени: проксита с неизвестни изходи се изключват и пулът никога не превключва към друга държава. Премиум изходът също следва списъка. При **exitClass**, зададен на `premium`, премиум изходът излиза от една от изброените държави, а държава, в която стандартният пул няма нищо, преминава към премиум изходи там. Без `premium` пул без съвпадение връща `code: "no_eligible_proxy"` с върнат обратно заявения обхват в `details.exitCountries`. Запазете обхвата и опитайте отново по-късно.

Когато прокси извикване успее под зададен обхват, лентата за отговор показва `exit <CODE>` до ID на проксито, за да можете да потвърдите, че обслужената държава съответства на поисканата от вас.

### Изходна локация (Proxy режим)

Групата **Exit location** в Proxy избира откъде излиза премиум изходът: регион, град, мрежа, устройство и колко дълго запазва адреса си. Списъците за регион, град и мрежа се попълват, когато **exitCountries** посочва точно една държава. Задайте **exitClass** на `premium`, тъй като всяко от тях изпраща заявката само през премиум изходи. Прокси ID в отговора запазва локацията, така че пренасянето му в Single или Browser е всичко, от което тези два режима се нуждаят. Вижте [Exit location](https://foura.ai/docs/api/endpoints#exit-location).

### Нулиране от лентата с инструменти

Бутонът **Reset** в лентата с инструменти (до **History** и **Saved**) изчиства средата до начално състояние. Тъй като действието е деструктивно, то отваря диалогов прозорец за потвърждение, който изброява точно какво ще бъде изтрито: всеки раздел със заявка, всички запазени cookies в контейнера, всички пренесени проксита и текущият отговор. Запазените предварителни настройки и избраният API ключ се запазват. Кликнете върху **Reset everything** за потвърждение; всяко друго действие отменя операцията.

## Изпращане и отказване

Кликнете върху **Send**, за да изпратите заявката. Дясната колона преминава в състояние на зареждане с индикатор и бутон **Cancel**, докато извикването се изпълнява. Кликнете върху Cancel (или натиснете бутона отново на мобилно устройство), за да прекратите. Отменената заявка възстановява празния контейнер със съобщение "Request canceled." вместо извеждане на грешка.

Картата с отговора превключва към резултата в момента, в който заявката приключи (или се провали). На телефон или в прозорец, достатъчно тесен, за да постави отговора под формата, страницата превърта картата с отговора в полезрението, когато тя се появи ниско на екрана. Автоматичните изпълнения могат да отнемат повече време от ръчните енджини, защото стъпковата последователност може да премине през няколко нива при непозната цел.

## Разчитане на отговора

Колоната с отговора отразява структурата на заявката със свои собствени раздели:

| Tab | Какво показва |
|-----|---------------|
| Body | Парсирано body. Превключва между JSON, HTML и Text изгледи в зависимост от върнатия резултат. |
| Headers | Headers на отговора, по един на ред. |
| Cookies | Cookies, върнати от целта, както в парсиран (групиран по host), така и в суров (Set-Cookie текст) изглед. Парсираният изглед показва значка `HO` за host-only cookies; domain cookies не са маркирани. |
| Raw | Пълният JSON плик, върнат от API. |

Лентата с инструменти за отговор съдържа **Copy** и **Download** за целия отговор, както и **Find in response** (Ctrl+K или Cmd+K) за търсене в отворения раздел, с Enter и Shift+Enter за навигиране между съвпаденията. Body, Headers и Cookies разполагат и със собствени бутони Copy и Download само за съответния раздел.

Мета лентата над разделите показва upstream HTTP статуса, общото време, ID на proxy, което е обслужило повикването, и (при Proxy повикване със scope) двубуквения `exit <CODE>`. Лентата показва също размера на отговора и, когато API ги отчита, кредитите, изразходвани от заявката. При Auto изпълнения стъпалото и опитите са описани в изречението под лентата.

### Какво беше необходимо за изпълнението

Изречение под мета лентата описва с думи какво е обслужило страницата. За Auto изпълнение то посочва стъпалото (сесия, с която FourA вече е разполагал за съответния host, обикновена заявка, ротиращо proxy, реален браузър или първоначално браузър и след това икономично повторение), дали е решен challenge, колко опита са били нужни и каква е цената. Когато заявката е задала `exitClass`, то показва също дали отговорът е доставен от премиум exit нода или от стандартния пул.

Когато някой от лимитите на плана ви е отказал повикването, изречението съобщава първо това: "Спряно от вашия план, а не от сайта", последвано от конкретния лимит (изчерпани браузърни заявки за днес, твърде много активни заявки в момента, изразходвани кредити за периода и т.н.) и връзка към [Usage & Limits](https://foura.ai/docs/dashboard/quota). Текстът се генерира от кода `X-FourA-Limit`, върнат от API, така че при неуспех на сложна страница разбирате дали ограничението идва от сайта, или от плана.

### Прехвърляне на стойности между изпълнения

След всяко изпълнение, върнало данни за сесия за многократна употреба, малък контрол **Carry** в лентата с инструменти за отговор показва наличните опции:

- **Auto** изпълнения с `returnSession` предлагат `userAgent` и `proxy` на сесията. Бисквитките на сесията се показват в раздел **Cookies** на отговора и се записват в cookie jar, когато опцията **Save response cookies** е включена.
- **Browser** изпълнения предлагат `userAgent` от отговора, както и ID на proxy, ако е било използвано такова.
- **Proxy** изпълнения предлагат върнатото ID на proxy и браузърния профил, ако ротацията е избрала такъв, различен от първоначално заявения.

Кликнете върху **Carry** и изберете с едно кликване къде да приложите всяка стойност: `userAgent` става header `User-Agent` в Single или Proxy, а ID на proxy се попълва в полето `proxy` в Single или Browser. Полетата, които получават прехвърлена стойност, показват червена точка за "модифицирано", за да виждате направените промени.

Прехвърленият **browser profile** попълва трите падащи менюта за os, browser и version и включва `unblocker`, същото правило, което важи и когато избирате профил ръчно. Предлага се само след като каталогът с профили е зареден, тъй като формулярът съдържа три падащи менюта, а не поле за id.

Профилът е единствената стойност, която показва, че заявката, която *проработи*, не е била точно въведената от вас: Proxy докладва `profile` само когато е преминал към фамилия браузъри, която не сте заявили. Повторете изпълнението без него и ще повторите версията, която се провали. Вижте [Why a Proxy Request Ran Out of Tries](https://foura.ai/docs/troubleshooting/proxy-attempt-report).

### Разгъване на цял екран

Иконата за разгъване в лентата с инструменти на отговора изважда картата с отговора от разделения изглед и я показва като слой на цял екран. Използвайте я за дълбоки JSON структури, дълги Set-Cookie логове или широк HTML body, където колоната с половин ширина става тясна. Самата страница спира да се скролва, докато слоят е отворен. Кликнете иконата отново (или натиснете Escape), за да я свиете.

## Възпроизвеждане с curl

В раздела **Raw** на заявката, под JSON, cURL блок показва точния еквивалент на командния ред за заявката, която изграждате, заедно с бутон **Copy curl**. Копирайте го, за да възпроизведете заявката от терминал, да я споделите с колега или да я поставите в доклад за бъг.

За ключове, които могат да се показват, бутонът **Reveal key** до фрагмента вмъква истинския ключ в чист текст директно в curl, за да можете да го копирате и изпълните директно. Кликнете отново, за да го скриете. Старите ключове (създадени преди пускането на функцията за разкриване) запазват плейсхолдър `PASTE_PLAINTEXT_FOR_<key-name>`; прегенерирайте ключа от страницата **API Keys**, за да може да се показва.

Разкриването се записва в одитния лог на сървъра всеки път, а ключът в чист текст остава в паметта само за текущата сесия на страницата.

## Запазване на предварителни настройки

Ако се налага да конфигурирате една и съща целева точка многократно, запазете я. Кликнете върху **Save** в реда с раздели на заявката, за да съхраните текущата конфигурация като наименуван шаблон.

Отворете **Saved** в лентата с инструменти, за да видите вашите предварителни настройки. Кликнете върху **Load**, за да попълните формуляра, или **Delete**, за да премахнете запис.

Заявка, отворена от раздела DevTools на разширението FourA Chrome, се зарежда с избрания ключ на разширението, когато този ключ е във вашия акаунт, и страницата го указва. В противен случай ще изиска от вас да изберете ключ. Повторена заявка, която не задава `unblocker`, се изпълнява с включена опция, както прави и API.

| Поле на шаблона | Какво съхранява |
|-----------------|-----------------|
| Name | Кратък етикет (до 100 знака) |
| Description | Незадължителни бележки (до 500 знака) |
| Endpoint | За кой engine е предназначен шаблонът (auto / single / proxy / browser) |
| Config | Пълният payload на заявката, включително UI полета, headers, cookies и body |

Шаблоните са видими само за вашия потребителски акаунт и не се споделят с членове на екипа.

## Повторно изпълнение от историята

Всяка заявка, която изпълнявате, се записва. Отворете **History** в лентата с инструменти, за да видите последните 20 изпълнения, сортирани от най-новите към по-старите.

Всеки ред показва endpoint, целевия URL, статус и време. Кликнете върху **Replay** на произволен ред, за да заредите тази заявка обратно във формата, след което изберете **Send**, за да я изпълните отново.

Историята е автоматично ограничена до вашия акаунт: виждате само собствените си изпълнения.

## Отваряне от Activity

Диалоговият прозорец с детайли в [Activity Log](https://foura.ai/docs/dashboard/activity-log) съдържа бутон **Open in Playground**. Кликнете върху него и Playground се зарежда както с архивираната заявка, така и с архивирания отговор. Формата се попълва от съхранения payload, а картата с отговора показва какво е върнало API в този момент с бадж "archived" върху лентата с метаданни за проксито ("archived <time> [, truncated] [, via <proxy>]").

Оттам можете да промените параметър и да изберете **Send**, за да изпълните нова заявка към реалното API, или просто да прегледате архивирания payload, без да го изпълнявате отново. Данните от payload се пазят 24 часа, така че по-старите редове в Activity няма да имат отговор за презареждане.

## Съвети

- Започнете в Playground, преди да пишете код за нова цел. При включен Auto ще разберете в рамките на секунди дали евтин fetch е достатъчен, или сайтът изисква обработка с браузър.
- За цели с географско ограничение изпълнете едно Proxy повикване със зададен `exitCountries`, след което подайте върнатия proxy ID в Browser повикване, за да може JavaScript рендирането да се извърши през същата изходна точка.
- Запазете preset за всяка цел, която извличате редовно. Повторното изпълнение на запазен preset отнема един клик; възстановяването на заявката по памет отнема повече време.
- Използвайте раздела Cookies за дебъгване на извличане, базирано на сесии. Суровият изглед на Set-Cookie показва точно какво е върнала целта.
- Когато целта ви отхвърли, опитайте друг запис в селекторите на Browser profile, преди да преминете към по-тежък engine. Смяната на подавания браузър е безплатна; рендирането през браузър не е.
- Заявките от Playground се таксуват към ключа, който изберете. Използвайте отделен ключ с ниска квота за общи тестове, ако искате да запазите производствената употреба чиста.

## Свързани

- [API Endpoints](https://foura.ai/docs/api/endpoints): Пълна справка за параметрите за четирите възможни engine, включително `exitCountries` и полетата за browser profile
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Как работи Auto зад кулисите
- [Choosing the Right Endpoint](https://foura.ai/docs/guides/choosing-task-type): Кога да изберете Auto срещу Single срещу Proxy срещу Browser
- [API Keys](https://foura.ai/docs/dashboard/api-keys): Управление на ключовете, с които удостоверявате заявките в Playground
- [Activity Log](https://foura.ai/docs/dashboard/activity-log): Отваряне на минала заявка директно в Playground
- [Dashboard Overview](https://foura.ai/docs/dashboard/overview): Всички секции на страничната лента
