Playground

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

Отворете го на 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.
  • 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.

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

Бутонът 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. Текстът се генерира от кода 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.

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

Иконата за разгъване в лентата с инструменти на отговора изважда картата с отговора от разделения изглед и я показва като слой на цял екран. Използвайте я за дълбоки 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 съдържа бутон Open in Playground. Кликнете върху него и Playground се зарежда както с архивираната заявка, така и с архивирания отговор. Формата се попълва от съхранения payload, а картата с отговора показва какво е върнало API в този момент с бадж "archived" върху лентата с метаданни за проксито ("archived

Оттам можете да промените параметър и да изберете 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: Пълна справка за параметрите за четирите възможни engine, включително exitCountries и полетата за browser profile
  • Smart Fetch (Auto): Как работи Auto зад кулисите
  • Choosing the Right Endpoint: Кога да изберете Auto срещу Single срещу Proxy срещу Browser
  • API Keys: Управление на ключовете, с които удостоверявате заявките в Playground
  • Activity Log: Отваряне на минала заявка директно в Playground
  • Dashboard Overview: Всички секции на страничната лента
Обновено: 11 ноември 2026 г.