# Песочница

> URL: https://foura.ai/ru/docs/dashboard/playground
> Updated: 2026-11-11
> Index: https://foura.ai/llms.txt

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

Откройте его по адресу [foura.ai/dashboard#playground](https://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](https://foura.ai/docs/api/endpoints#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](https://foura.ai/docs/api/endpoints#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](https://foura.ai/docs/dashboard/quota). Эта строка формируется на основе кода `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 закончились попытки](https://foura.ai/docs/troubleshooting/proxy-attempt-report).

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

Значок развертывания на панели инструментов ответа выносит карточку ответа из разделенного макета в полноэкранный оверлей. Используйте его для глубоких деревьев 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](https://foura.ai/docs/dashboard/activity-log) есть кнопка **Open in Playground**. Нажмите ее, и Playground загрузится с архивными request и response. Форма заполнится сохраненными данными payload, а карточка ответа покажет то, что вернул API в тот момент, с отметкой "archived" на панели proxy meta ("archived <time> [, truncated] [, via <proxy>]").

Оттуда вы можете изменить параметр и нажать **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](https://foura.ai/docs/api/endpoints): полный справочник параметров для всех четырех движков, включая `exitCountries` и поля профиля браузера
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): что делает Auto под капотом
- [Choosing the Right Endpoint](https://foura.ai/docs/guides/choosing-task-type): когда выбирать Auto, Single, Proxy или Browser
- [API Keys](https://foura.ai/docs/dashboard/api-keys): управление ключами для аутентификации запросов в Playground
- [Activity Log](https://foura.ai/docs/dashboard/activity-log): открытие прошлых запросов напрямую в Playground
- [Dashboard Overview](https://foura.ai/docs/dashboard/overview): все разделы боковой панели
