Playground

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

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

Какво прави

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

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

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

Избор на ключ

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

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

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

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

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

Ред с URL адрес

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

Раздели за заявката

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

Раздел	Какво контролира
UI	Полета на формата за таймаути, пренасочвания, флагове, proxy, специфични за браузъра опции и правила за валидиране
Body	Тяло в свободна форма за POST / PUT / PATCH заявки
Headers	Потребителски headers на заявката като двойки ключ-стойност
Cookies	Cookies, които да се изпратят със заявката
Raw	Точният JSON полезен товар, който ще бъде изпратен, с възможност за директно редактиране

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

UI Pane Sections

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

• Timeouts: timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec. Auto показва само timeout_ms (общия бюджет).
• Redirects: превключване и задаване на followRedirects (0-20). Single, Proxy, Auto. Browser следва пренасочванията самостоятелно.
• Flags: unblocker за Single, Proxy и Browser (unblocker в Browser задейства автоматичното решаване на защитата); tryJsonData и returnBuffer за Single и Proxy. Auto показва forceProxy и returnSession вместо това.
• Proxy: изберете конкретен proxy ID за Single или Browser или задайте maxTries, външното време за изчакване на Proxy, exitCountries и ignoreProxies за двигателя на Proxy. Auto също показва ignoreProxies.
• Browser profile: три падащи менюта, os, browser и version, изброяващи това, което FourA действително може да представи. Те се появяват в режим Single и Proxy. Оставете ги празни за най-новия Chrome. Всеки избор стеснява останалите два, така че никога не се появява комбинация, която води до нищо. Секцията изисква Web Unblocker да е включен: ако е изключен, не се изпращат заглавки на браузъра, профилът ще се приложи само наполовина и API отхвърля заявката вместо това.
• Browser: опции само за браузър, като checkStatus и checkText.
• Validate: validate.status (кодове на състояние), validate.headers (правила за двойки ключ-стойност на заглавките) и validate.data (поднизове за приемане / отхвърляне на тялото, алтернативи, разделени с |) правила за приемане / отхвърляне. Налично за всеки Mode, включително Auto.

Exit Country Scoping (Proxy Mode)

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

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

Toolbar Reset

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

Изпращане и отмяна

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

Панелът за response се превключва към резултата в момента, в който вашият request завърши (или се провали). Автоматичните (Auto) изпълнения могат да отнемат повече време от ръчните, тъй като процесът може да премине през няколко стъпки при непозната цел.

Четене на response

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

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

Информационна лента над разделите показва upstream HTTP статуса, общото време, ID на използваното proxy, което е обработило извикването, и (за насочено Proxy извикване) двубуквения exit <CODE>. За Auto изпълнения лентата показва също коя стъпка е доставила вашия response, колко под-опита са направени и изразходваните кредити.

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

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

• Auto изпълненията предлагат пълната тройка session (proxy, cookies, userAgent).
• Browser изпълненията предлагат response userAgent, плюс proxy ID, ако е използвано такова.
• Proxy изпълненията предлагат върнатото proxy ID.

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

Разширяване на цял екран

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

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

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

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

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

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

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

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

Поле за Preset	Какво съхранява
Име	Кратък етикет (до 100 знака)
Описание	Незадължителни бележки (до 500 знака)
Endpoint	За кой engine е предназначен preset-ът (auto / single / proxy / browser)
Config	Пълният payload на request-а, включително 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 в този момент със значка "archived" върху мета лентата на proxy ("archived [, truncated] [, via ]").

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

Съвети

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

Свързани

• API Endpoints: Пълна справка за параметрите за всички четири engine, включително exitCountries и полетата за профила на браузъра
• Smart Fetch (Auto): Какво прави Auto под капака
• Choosing the Right Endpoint: Кога да изберете Auto срещу Single срещу Proxy срещу Browser
• API Keys: Управление на ключовете, с които удостоверявате заявките в Playground
• Activity Log: Отваряне на минала заявка директно в Playground
• Dashboard Overview: Всички раздели на страничната лента