Playground

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

Откройте его по ссылке foura.ai/dashboard#playground.

Что это делает

Одна форма. Четыре движка. Реальный трафик.

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

Запросы выполняются с ключом API, который вы выбираете в верхней части страницы. Использование учитывается в квоте этого ключа так же, как и production-вызов, поэтому не исчерпайте свой тарифный план при тестировании.

Выбор ключа

В выпадающем списке ключей API отображаются все активные ключи в вашей области видимости: личные ключи, ключи организации, которыми вы управляете, и общие ключи команды, к которым у вас есть доступ. Выберите тот, с которого будет списываться плата за request. Если у вас еще нет активных ключей, встроенная подсказка направит вас на страницу API Keys для его создания.

Выбор режима

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

Mode	Когда использовать
Auto	Новая цель или сайт со смешанной защитой. Auto выбирает самый дешевый путь и запоминает, что работает.
Single	Быстрый HTTP fetch. Лучший начальный выбор для известного хоста.
Proxy	Такой же fetch с автоматической ротацией proxy. Установите exitCountries, когда требуется страна, видимая для цели.
Browser	Загружает страницу в инстансе браузера Chrome. Используйте, когда данные появляются только после выполнения JavaScript.

Создание request

Строка URL

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

Вкладки request

Под строкой URL пять вкладок позволяют заполнить все остальное:

Вкладка	Что она контролирует
UI	Поля формы для таймаутов, редиректов, флагов, proxy, специфичных для браузера опций и правил validate
Body	Произвольный body для request POST / PUT / PATCH
Headers	Пользовательские request headers в виде пар ключ-значение
Cookies	Cookies для отправки с request
Raw	Точный JSON payload, который будет отправлен, с возможностью прямого редактирования

Все, что вы меняете в 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. 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: выбор конкретного ID proxy для Single или Browser, либо установка maxTries, внешнего таймаута Proxy, exitCountries и ignoreProxies для движка Proxy. Auto также показывает ignoreProxies.
• Профиль браузера: три каскадных выпадающих списка: os, browser и version, в которых перечислено, что FourA действительно может представить. Они отображаются в режиме Single и Proxy. Оставьте их пустыми для новейшей версии Chrome. Каждый выбор сужает два других, поэтому комбинация, которая ни к чему не приводит, никогда не появляется. Раздел требует включения Web Unblocker: если он выключен, заголовки браузера не отправляются, профиль будет применен только наполовину, и API вместо этого отклонит request.
• Browser: опции, доступные только для браузера, такие как checkStatus и checkText.
• Validate: правила принятия / отклонения validate.status (коды состояния), validate.headers (правила ключ-значение заголовка) и validate.data (подстроки принятия / отклонения тела, альтернативы, разделенные |). Доступно для каждого Mode, включая Auto.

Ограничение страны выхода (режим Proxy)

Поле exitCountries в Proxy принимает разделенный запятыми список двухбуквенных кодов стран, видимых целевому ресурсу (CZ, GB). Значения обрезаются, переводятся в верхний регистр и дедублицируются при отправке. Выбор представляет собой строгий белый список: proxies с неизвестными выходами исключаются, и request никогда не переключается на другую страну. Если в текущем пуле нет совпадений, в response возвращается code: "no_eligible_proxy" с запрошенной областью действия, возвращенной в details.exitCountries. Сохраните область действия и повторите попытку позже.

Когда вызов proxy выполняется успешно с ограничением области действия, полоса ответа показывает exit <CODE> рядом с ID proxy, чтобы вы могли убедиться, что обслуживаемая страна соответствует запрошенной.

Сброс панели инструментов

Кнопка Reset на панели инструментов (рядом с History и Saved) очищает песочницу до начального состояния. Поскольку это необратимое действие, открывается диалоговое окно подтверждения с точным списком того, что будет удалено: все три формы продуктов (Single, Proxy, Browser), любые сохраненные cookie в хранилище, любые перенесенные proxy и текущий response. Сохраненные пресеты и выбранный API-ключ остаются. Нажмите Reset everything для подтверждения; любое другое действие отменяет операцию.

Отправка и отмена

Нажмите Send для запуска request. Правая колонка переключается в состояние загрузки со спиннером и кнопкой Cancel, пока выполняется вызов. Нажмите Cancel (или нажмите кнопку еще раз на мобильном устройстве) для прерывания. Отмененный request возвращает исходный плейсхолдер с текстом "Request canceled." вместо вывода ошибки.

Карточка response переключается на результат в момент завершения (или сбоя) request. Выполнение Auto может занимать больше времени по сравнению с ручными механизмами, поскольку алгоритму может потребоваться пройти несколько этапов при холодном target.

Чтение Response

Колонка response повторяет структуру request и имеет собственные вкладки:

Вкладка	Что отображается
Body	Разобранное тело. Переключается между форматами JSON, HTML и Text в зависимости от полученных данных.
Headers	Заголовки response, по одному на строку.
Cookies	Cookie, возвращенные от target, как в разобранном виде (сгруппированные по хостам), так и в сыром (текст Set-Cookie). Разобранный вид показывает бейдж HO на cookie, привязанных только к хосту; доменные cookie не помечаются.
Raw	Полный конверт JSON, возвращенный API.

Мета-панель над вкладками показывает HTTP-статус upstream, общее время, ID proxy, который обработал вызов, и (для вызовов Proxy с областью действия) двухбуквенный exit <CODE>. Для выполнений Auto панель также показывает, на каком этапе был получен response, количество выполненных подзапросов и потраченные кредиты.

Перенос значений между выполнениями

После любого выполнения, вернувшего данные сессии для повторного использования, небольшой элемент управления Carry на панели response показывает доступные данные:

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

Нажмите Carry и выберите, куда применить каждое значение в один клик: userAgent становится заголовком User-Agent в Single или Proxy, а ID proxy подставляется в поле proxy в Single или Browser. Поля, получающие перенесенное значение, отображают красную точку "modified", чтобы вы могли видеть изменения.

Развертывание на весь экран

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

Воспроизведение через curl

Под ответом блок curl показывает точный эквивалент командной строки для запроса, который вы только что создали. Скопируйте его, чтобы воспроизвести запрос из терминала, поделиться им с коллегой или вставить в отчет об ошибке.

Для раскрываемых ключей кнопка Reveal key рядом с фрагментом подставляет настоящий ключ в виде обычного текста прямо в curl, чтобы вы могли скопировать и запустить его как есть. Нажмите еще раз, чтобы скрыть. Устаревшие ключи (созданные до выпуска функции раскрытия) сохраняют заполнитель PASTE_PLAINTEXT_FOR_<key-name>; пересоздайте ключ на странице API Keys, чтобы сделать его раскрываемым.

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

Сохранение пресетов

Если вы обнаружите, что постоянно настраиваете одну и ту же цель, сохраните ее. Нажмите Save в строке вкладок запроса, чтобы сохранить текущую конфигурацию в виде именованного пресета.

Откройте Saved на панели инструментов, чтобы просматривать, переименовывать или удалять свои пресеты. Нажмите на любой пресет, чтобы загрузить его обратно в форму.

Поле пресета	Что оно хранит
Name	Короткая метка (до 100 символов)
Description	Необязательные заметки (до 500 символов)
Endpoint	Для какого движка предназначен пресет (auto / single / proxy / browser)
Config	Полная полезная нагрузка запроса, включая поля пользовательского интерфейса, заголовки, файлы cookie и тело

Пресеты привязаны к вашей учетной записи пользователя и не видны членам команды.

Повтор из истории

Каждый выполняемый вами запрос записывается в журнал. Откройте History на панели инструментов, чтобы увидеть свои последние 20 запусков, отсортированные от самых новых.

Каждая строка показывает endpoint, целевой URL, статус и время. Нажмите Replay в любой строке, чтобы снова загрузить этот запрос в форму, затем Send, чтобы выполнить его еще раз.

История автоматически привязана к вашей учетной записи: вы видите только свои собственные запуски.

Открытие из активности

В диалоговом окне сведений Activity Log есть кнопка Open in Playground. Нажмите ее, и Playground загрузится с архивированным запросом и архивированным ответом. Форма заполняется из сохраненной полезной нагрузки, а карточка ответа показывает, что API вернул в тот момент со значком "archived" на полосе метаданных прокси ("archived [, truncated] [, via ]").

Оттуда вы можете изменить параметр и нажать Send, чтобы выполнить новый запрос к работающему API, или просто просмотреть архивированную полезную нагрузку без повторного выполнения. Полезные нагрузки хранятся в течение 24 часов, поэтому старые строки активности не будут иметь перезагружаемого ответа.

Советы

• Начинайте работу в Playground перед написанием кода для новой цели. С включенным Auto вы за несколько секунд узнаете, достаточно ли дешевого fetch или сайт требует решения через браузер.
• Для целей с блокировкой по стране выполните один вызов Proxy с заданным exitCountries, затем передайте полученный proxy ID в вызов Browser, чтобы рендеринг JavaScript происходил через тот же выходной узел.
• Сохраняйте пресет для каждой цели, которую вы регулярно парсите. Повторный запуск сохраненного пресета требует одного клика, а восстановление запроса по памяти занимает больше времени.
• Используйте вкладку Cookies для отладки скрейпинга на основе сессий. Представление raw Set-Cookie показывает точно, что отправила цель.
• Если цель вам отказывает, попробуйте выбрать другой профиль в списках Browser, прежде чем переходить на более тяжелый движок. Смена представленного браузера бесплатна, а рендеринг в браузере нет.
• Запросы в Playground тарифицируются по выбранному вами ключу. Используйте отдельный ключ с низкими квотами для обычных экспериментов, если хотите сохранить статистику production чистой.

Связанные материалы

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