Playground е активен във вашия Dashboard. Три endpoints, един cookie jar, всеки header е парснат. Изберете Single, Proxy или Browser, попълнете заявката и натиснете Send. Полученият response се появява на същия екран със статус, headers, body и парснати cookies. Когато сте готови, копирайте работещата curl команда в кода си.
Това не е отделна страница или sandbox зад различен URL. Работи директно с реалното API през вашия истински ключ. Това, което виждате в Playground, е точно това, което ще получи вашият производствен код.
Как работи
Влизате в Dashboard, избирате един от трите endpoints и формата се преструктурира автоматично, за да покаже само полетата, които този endpoint реално приема.
- Single получава
url,method,headers,unblocker,proxy,tryJsonData,followRedirectsи групата за timeout. - Proxy получава същия набор, обвит в блок
request, плюс филтрите за избор на proxy (държава, град, ASN, анонимност, актуалност). - Browser получава
url,cookies,headersи условията за изчакване.
Когато натиснете Send, Dashboard автентикира повикването през вашия профил и изпраща POST заявка към /api/{endpoint} на api.foura.ai. Вашият реален API ключ никога не преминава през страницата. Playground е единственото място в Dashboard, където можете да изпратите таксувана заявка, без да разкривате ключа в браузъра.
Ето готовата curl команда, която Playground генерира за базова Single заявка:
curl -X POST 'https://api.foura.ai/api/single' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
--data-raw '{
"url": "https://example.com/products",
"method": "GET",
"unblocker": true,
"tryJsonData": true
}'
Поставете това в терминал или в билд скрипт и то ще се държи точно като бутона Send. Не обвиваме payload-а в персонализиран envelope и не преименуваме нито едно от полетата. Playground изпраща точно това, което приема API, точка.
Какво виждате в отговор
Панелът за отговор показва статуса от upstream сървъра, общото време и (за Proxy заявки) proxy id, което е обработило заявката. Body, Headers и Cookies получават отделен таб.
Body. Автоматично засеченият JSON се визуализира в падащ преглед със свиване. HTML payload превключва към панел за предварителен преглед, за да видите директно какво е върнал целевият сайт. Текстът се показва в изчистен monospace изглед. В Body и Raw има поле за търсене с навигация напред/назад.
Headers. Парснат изглед с един ред за всеки name: value, или Raw за цялата верига от отговори при множество пренасочвания. Всяко пренасочване оставя собствен набор от хедъри, така че проследяването на 302 до крайната дестинация става с един клик.
Cookies. Cookie jar парсва всеки Set-Cookie ред от отговора, следи дали всяка бисквитка е host-only или domain-wide (RFC 6265 §5.3) и предлага два изгледа: сгъваеми карти за всеки хост или суров списък. Включете cookie jar и следващата заявка автоматично ще вземе съответстващите бисквитки. За Single и Proxy това означава хедър Cookie в изходящата заявка. За Browser това означава масив от бисквитки, прикачен към обекта на заявката.
Шаблоните (Presets) запазват цялата конфигурация на заявката под име и описание, за да можете да се върнете към "test login on staging", без да я изграждате наново. Историята пази последните ви двадесет изпълнения със статус, content type, общо време и използваното прокси.
Ефект
Това, което Playground реално променя, е цикълът на итерация.
Преди пишехте малък скрипт (Node, Python или shell), свързвахте ключа си, изпращахте заявка към API, отпечатвахте тялото, коригирахте един хедър, пускахте го отново. Може би десет минути от "чудя се какво връща този сайт" до получаването на отговор.
В Playground този цикъл е близо петнадесет секунди. Кликвате на endpoint, поставяте URL, натискате Send, преглеждате бисквитките, променяте unblocker от off на on, натискате Send отново. Докато отворите редактора си, вече знаете коя версия на заявката работи с вашата цел.
Не пуснахме Playground, за да заменим реалния ви код. Пуснахме го, за да може пътят от "това изобщо възможно ли е на този сайт" до "да, ето cURL командата, която работи" да спре да изисква отделен страничен проект.
За напреднали
Няколко неща, които не са очевидни на пръв поглед:
Шаблоните носят пълния payload. Това включва timeout групата, правилата за валидация, лимита на пренасочвания и всички персонализирани хедъри. Когато запазвате шаблон, правите моментна снимка на тествана заявка, а не просто на URL адреса. Полезно е, когато поддържате набор от стабилни smoke тестове между различни endpoints.
Cookie jar се пази за всяка сесия поотделно. Намира се в браузъра ви. Не запазваме прихванатите бисквитки от страна на сървъра. Презаредете таба с твърдо опресняване, ако ви трябва чисто състояние.
Разделът Raw и формата остават синхронизирани. Полетата на формата рендират същия JSON, който показва разделът Raw. Поставете payload в Raw и формата се рехидратира. Така колега може да пусне работещ request в чата, вие го поставяте в Raw и формата се попълва сама.
Бисквитките на браузъра са под формата на обект, а не на header. Ако изпращате cookies към Browser endpoint ръчно, всеки запис приема {name, value, domain?, path?, httpOnly?, secure?, sameSite?}. Playground ги изгражда правилно, когато jar е включен. Ако ги създавате сами, съответствието със схемата има значение.
Резултатите се показват във вашия activity feed. Когато Playground изпрати request, той се отчита като всяко друго извикване към вашия ключ. Ще го видите във вашия activity log с правилния етикет за резултат (success, client_error, application_error, rate_limit, service_error). Полезно за възпроизвеждане на нестабилно production извикване: пуснете го отново в Playground, намерете го в activity log и споделете връзката с екипа.
Какво следва
Playground е първата стъпка от по-голяма инициатива Dashboard да прави повече от това просто да показва какво вече сте направили. Моделите, които виждаме в дневника на заявките, определят какво ще пуснем след това.
Ако го използвате днес и нещо не ви се струва наред, поле, което не отговаря на документацията, cookie, което не е оцеляло след redirect, response, който се рендира грешно, това е обратната връзка, която четем първо. Dashboard вижда заявките. Ние виждаме тенденциите.