Playground

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

Отворете го на foura.ai/dashboard#playground.

Какво прави

Една форма. Три engines. Реален трафик.

Single: директен HTTP fetch с реалистични, наподобяващи браузър мрежови характеристики
Proxy: управляван rotating proxy fetch
Browser: отваря URL адреса в Chrome browser инстанция за JS-rendered сайтове

Requests се изпълняват спрямо API key, който изберете в горната част на страницата. Потреблението се отчита към квотата на този ключ по същия начин, по който и production call, така че не изразходвайте плана си по време на тестове.

Избор на ключ

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

Избор на продукт

Три бутона (pills) се намират над формата: Single, Proxy, Browser. Превключването им променя видимите полета и това кой engine се извиква от request. Текущият избор се запазва при презареждане на страницата.

Product	Кога да се използва
Single	Бърз HTTP fetch. Най-добрият първи избор за всеки URL.
Proxy	Същият fetch с автоматична proxy ротация. Използвайте, когато Single бива блокиран.
Browser	Зарежда страницата в Chrome browser инстанция. Използвайте, когато данните се появяват само след изпълнение на JavaScript.

Изграждане на Request

URL ред

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

Request раздели

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

Раздел	Какво контролира
UI	Полета на формата за timeouts, redirects, flags, proxy, специфични за browser опции и validate правила
Body	Свободен текст за body при POST / PUT / PATCH requests
Headers	Персонализирани request headers като двойки ключ-стойност
Cookies	Cookies, които да се изпратят с request
Raw	Точният JSON payload, който ще бъде изпратен, с възможност за директно редактиране

Всяка промяна в UI / Body / Headers / Cookies се отразява в Raw. Редактирането на Raw също работи, като останалите раздели се актуализират съответно.

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

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

Timeouts: timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec
Redirects: превключване и задаване на followRedirects (0-20). Само за Single + Proxy. Browser следва redirects самостоятелно.
Flags: unblocker, tryJsonData, returnBuffer. Single + Proxy.
Proxy: изберете конкретен proxy ID за Single или Browser, или задайте maxTries, външния timeout за Proxy и ignoreProxies за Proxy engine.
Browser: опции само за browser, като например checkStatus и checkText.
Validate: правила за приемане / отхвърляне (accept / fail) за validate.status (status codes), validate.headers (правила за header ключ-стойност) и validate.data (поднизове за приемане / отхвърляне в body, разделени с | алтернативи).

Полетата, които не се отнасят за текущо избрания продукт, са скрити.

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

Бутонът Reset в лентата с инструменти (до History) нулира формата на активния продукт до нейните стойности по подразбиране. Настройките по подразбиране оставят unblocker и tryJsonData включени, което съответства на най-често срещаната начална точка. Използвайте го, когато сте се отдалечили твърде много от работеща конфигурация и искате да започнете начисто, без да презареждате страницата.

Изпращане и анулиране

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

Картата с response се превключва към резултата в момента, в който request завърши (или се провали).

Четене на Response

Колоната с response отразява оформлението на request със свои собствени раздели:

Раздел	Какво показва
Body	Парснат body. Превключва между изгледи за JSON, HTML и Text в зависимост от върнатия резултат.
Headers	Response headers, по един на ред.
Cookies	Cookies, върнати от целта, както в парснат изглед (групирани по хост), така и в raw изглед (текст на Set-Cookie). Парснатият изглед показва `HO` badge за host-only cookies, а domain cookies са без маркировка.
Raw	Целият JSON envelope, върнат от API.

Информационна лента над разделите показва HTTP status от сървъра, общото време и (за Proxy / single-with-proxy-id requests) съответния proxy ID, обработил повикването. Бутоните за копиране и изтегляне се намират в горния десен ъгъл на всеки панел, така че можете да изтеглите body или headers във файл с едно кликване.

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

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

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

Под response блокът с curl показва точния еквивалент на командния ред за request, който току-що сте изградили. Копирайте го, за да възпроизведете request от терминал, да го споделите с колега или да го поставите в доклад за грешка.

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

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

Запазване на Presets

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

Отворете Saved в лентата с инструменти, за да преглеждате, преименувате или изтривате вашите presets. Кликнете върху някой preset, за да го заредите обратно във формата.

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

Presets са ограничени до вашия потребителски акаунт и не се споделят с членовете на екипа.

Повторно изпълнение от History

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

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

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

Отваряне от Activity

Диалоговият прозорец с подробности за Activity Log има бутон Open in Playground. Кликнете върху него и Playground се зарежда както с архивирания request, така и с архивирания response. Формата се попълва от съхранения payload, а картата с response показва какво е върнал API в този момент с badge "archived" върху информационната лента за proxy ("archived [· truncated] [· via ]").

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

Съвети

Започнете в Playground, преди да пишете код за нова цел. Ще разберете в рамките на секунди дали Single е достатъчен или имате нужда от Browser.
Запазвайте preset за всяка цел, която скрапвате редовно. Повторното изпълнение на запазен preset отнема едно кликване, докато възстановяването на request по памет отнема повече време.
Използвайте раздела Cookies, за да дебъгвате скрапване, базирано на сесии. Raw изгледът на Set-Cookie показва точно какво е изпратила целта.
Playground requests се таксуват спрямо ключа, който изберете. Използвайте специален ключ с ниска квота за случайни проучвания, ако искате да запазите потреблението на production чисто.

Свързани теми

API Endpoints: Пълна справка за параметрите за трите продукта
Choosing the Right Endpoint: Кога да изберете Single спрямо Proxy спрямо Browser
API Keys: Управлявайте ключовете, с които удостоверявате Playground requests
Activity Log: Отворете минал request директно в Playground
Dashboard Overview: Всички секции на страничната лента

Обновено: 30 юни 2026 г.