Песочница

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

Откройте его по адресу foura.ai/dashboard#playground.

Что это такое

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

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

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

Выбор ключа

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

Выбор режима

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

Режим Когда использовать
Auto Новая цель или сайт со смешанной защитой. Auto выбирает самый дешевый путь и запоминает рабочий вариант.
Single Быстрый HTTP-fetch. Лучший первый выбор для известного хоста.
Proxy Тот же fetch с автоматической ротацией 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, настроек браузера и правил validate
Body Произвольное тело для запросов POST / PUT / PATCH
Headers Пользовательские заголовки request в виде пар ключ-значение
Cookies Cookie jar, который хранится для каждого хоста в этом браузере. Опция Use jar прикрепляет подходящие cookie к request, а Save response cookies сохраняет cookie из response. Обе включены по умолчанию, и вкладка показывает превью того, что отправит этот request
Raw Точный JSON payload, который будет отправлен, в виде превью только для чтения с кнопкой Copy JSON, и команда для воспроизведения через curl под ним

Любые изменения во вкладках UI / Body / Headers / Cookies сразу видны в Raw. Редактировать Raw напрямую нельзя: меняйте request на других вкладках. Красная точка появляется на любой вкладке или раскрывающемся блоке, где значение отличается от дефолтного в движке, поэтому вы сразу видите свои изменения.

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

Когда в результате выполнения получен рабочий proxy, в конце вкладки интерфейса появляется раздел Working proxies. В нем перечислено до 20 ID proxy, сначала самые новые, с указанием страны выхода и времени. Кнопка use подставляет значение в поле proxy для Single или Browser (движок Proxy находит его сам), а × удаляет запись из списка.

Выбор страны выхода (режим Proxy)

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

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

Exit Location (режим Proxy)

Группа Exit location в Proxy определяет, откуда именно выходит премиум-прокси: регион, город, сеть, устройство и длительность сохранения адреса. Списки регионов, городов и сетей заполняются, когда в exitCountries указана ровно одна страна. Установите exitClass в premium, так как любой из этих параметров направляет запрос исключительно через премиум-выходы. Идентификатор прокси в ответе сохраняет локацию, поэтому для режимов Single или Browser достаточно передать только его. См. Exit location.

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

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

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

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

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

Чтение ответа

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

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

Панель инструментов ответа содержит кнопки Copy и Download для всего ответа, а также Find in response (Ctrl+K или Cmd+K) для поиска по открытой вкладке, с навигацией по совпадениям через Enter и Shift+Enter. Для вкладок Body, Headers и Cookies также предусмотрены отдельные кнопки Copy и Download только для содержимого этой вкладки.

Информационная полоса над вкладками показывает HTTP статус апстрима, общее время, ID proxy, обработавшего вызов, и (для вызова Proxy с областью видимости) двухбуквенный exit <CODE>. Полоса также отображает размер ответа и, если API сообщает о них, списанные за request кредиты. Для запусков в режиме Auto уровень и количество попыток указаны в строке под полосой.

Что потребовалось для вызова

Строка под информационной полосой текстово поясняет, как была получена страница. Для запуска в режиме Auto в ней указан уровень (сессия, которая уже была у FourA для этого хоста, простой request, ротируемый proxy, реальный браузер или сначала браузер, а затем дешевый повторный запрос), была ли пройдена проверка, сколько попыток потребовалось и какова стоимость. Если в request был задан exitClass, там также сообщается, был ли ответ доставлен через премиум выход или через стандартный пул.

Если вызов был отклонен из-за лимитов вашего тарифного плана, строка сначала сообщает: "Остановлено вашим тарифным планом, а не сайтом", после чего указывает конкретный лимит (исчерпаны запросы браузера на сегодня, слишком много активных запросов в обработке, потрачены кредиты за текущий период и так далее) и ссылку на Usage & Limits. Эта строка формируется на основе кода X-FourA-Limit, возвращенного API, поэтому при сбое загрузки сложной страницы вы точно знаете, была ли она заблокирована сайтом или остановлена лимитами плана.

Перенос значений между запусками

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

  • Запуски в режиме Auto, выполненные с returnSession, предлагают userAgent и proxy сессии. Cookie сессии отображаются на вкладке Cookies ответа и сохраняются в хранилище cookie, когда включена опция 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 только тогда, когда он переключился на семейство браузеров, которое вы не запрашивали. Повторите запрос без него, и вы повторите версию, завершившуюся ошибкой. См. Почему у запроса через Proxy закончились попытки.

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

Значок развертывания на панели инструментов ответа выносит карточку ответа из разделенного макета в полноэкранный оверлей. Используйте его для глубоких деревьев JSON, длинных дампов Set-Cookie или широких тел HTML, где колонка половинной ширины становится тесной. Сама страница прекращает прокручиваться, пока открыт оверлей. Нажмите значок еще раз (или нажмите 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 Для какого движка предназначен пресет (auto / single / proxy / browser)
Config Полная полезная нагрузка запроса, включая поля интерфейса, headers, cookies и body

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

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

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

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

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

Открытие из Activity

В окне деталей Activity Log есть кнопка Open in Playground. Нажмите ее, и Playground загрузится с архивными request и response. Форма заполнится сохраненными данными payload, а карточка ответа покажет то, что вернул API в тот момент, с отметкой "archived" на панели proxy meta ("archived

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

Советы

  • Начните в Playground перед написанием кода для новой цели. С включенным режимом Auto вы за секунды поймете, хватит ли простого fetch или сайт требует запуска браузера.
  • Для сайтов с гео-ограничениями выполните один вызов Proxy с установленным exitCountries, затем передайте полученный proxy ID в вызов Browser, чтобы рендеринг JavaScript шел через тот же выходной узел.
  • Сохраняйте пресет для каждой цели, которую вы регулярно парсите. Повторный запуск сохраненного пресета занимает один клик; сборка параметров вручную займет больше времени.
  • Используйте вкладку Cookies для отладки парсинга на основе сессий. Необработанные заголовки Set-Cookie показывают именно то, что отправил целевой сайт.
  • Если сайт блокирует запрос, попробуйте выбрать другой профиль в Browser profile selects перед переходом на более тяжелый движок. Смена передаваемого профиля браузера бесплатна, а запуск рендеринга в браузере списывает средства.
  • Запросы в Playground тарифицируются по выбранному вами ключу. Используйте отдельный ключ с низким лимитом для тестов, чтобы не смешивать статистику с продакшеном.
  • API Endpoints: полный справочник параметров для всех четырех движков, включая exitCountries и поля профиля браузера
  • Smart Fetch (Auto): что делает Auto под капотом
  • Choosing the Right Endpoint: когда выбирать Auto, Single, Proxy или Browser
  • API Keys: управление ключами для аутентификации запросов в Playground
  • Activity Log: открытие прошлых запросов напрямую в Playground
  • Dashboard Overview: все разделы боковой панели
Обновлено: 11 ноября 2026 г.