Эта статья была полезной?
Как использовать режим песочницы
Технический специалист
Введение
Если вы разрабатываете интеграцию с RuCaptcha и хотите проверить, как ваше приложение отправляет задачи и обрабатывает ответы, режим песочницы (sandbox) — ваш основной инструмент отладки.
В этом режиме вы видите капчи в интерфейсе и решаете их самостоятельно. Это позволяет проверить весь цикл работы: от формирования запроса до получения ответа, без привлечения работников. Статья описывает настройку песочницы, ограничения по типам капч и рекомендации по эффективному тестированию.
Важно: режим песочницы доступен только после первого пополнения аккаунта.
Общие сведения
Режим песочницы — это специальный режим аккаунта RuCaptcha, при котором отправленные задачи не распределяются между работниками, а отображаются в вашем личном интерфейсе для ручного решения.
Ключевые особенности:
- Оплата не списывается — песочница бесплатна
- Задачи не попадают в общую очередь работников
- Вы контролируете время и качество решения
- Идеально подходит для отладки логики, проверки параметров и обработки ошибок
Важно: после завершения тестов обязательно отключите песочницу. Иначе все новые задачи будут оставаться в вашем интерфейсе и не будут передаваться работникам на решение.
Подготовка окружения
Перед включением режима убедитесь, что у вас есть:
- Активный аккаунт в RuCaptcha
- Настроенный скрипт или приложение, отправляющее задачи через API
- Понимание, какие типы капч вы планируете тестировать
Для работы с приложением работников (рекомендуемый способ) потребуется:
- Скачать последнюю версию CaptchaBotRS с официального репозитория
- Переключиться в интерфейс работника в правом верхнем углу страницы rucaptcha.com
- Скопировать worker key и указать его в настройках приложения
Анализ страницы
Не все типы капч поддерживаются в режиме песочницы. Перед тестированием проверьте совместимость:
| Тип капчи | Поддержка в песочнице |
|---|---|
| reCAPTCHA v2/reCAPTCHA Enterprise | Да |
| hCaptcha | Да |
| FunCaptcha | Да |
| GeeTest V3/V4 | Да |
| Все простые капчи | Да |
| Amazon | Да |
| Friendly | Да |
| Tencent | Да |
| CaptchaFox | Да |
| reCAPTCHA v3 | Нет |
| Cloudflare Turnstile | Нет |
| VK CAPTCHA | Нет |
| DataDome | Нет |
Реализация
Включение режима песочницы выполняется в настройках аккаунта:
- Перейдите в раздел настроек
- Активируйте переключатель Sandbox Mode
- Сохраните изменения
После включения все новые задачи, отправленные через API с вашим ключом, будут отображаться в интерфейсе песочницы.
Использование приложения работников
Для тестирования токен-капч (reCAPTCHA v2, GeeTest и др.) мы рекомендуем использовать приложение CaptchaBotRS вместо веб-интерфейса.
После установки приложения:
- Переключитесь в интерфейс работника на сайте rucaptcha.com
- Скопируйте отображаемый worker key
- Вставьте ключ в настройки CaptchaBotRS
- Запустите приложение и дождитесь подключения
Типичные ошибки
Самой частой проблемой при использовании песочницы является бесконечное ожидание загрузки капчи в приложении. Обычно это свидетельствует о том, что в отправленных параметрах допущена ошибка или капча не поддерживается режимом песочницы.
Если вы уверены, что тип капчи точно можно получить в этом режиме, то перепроверьте данные, которые вы отправляете. Рекомендуем извлечь их повторно и попробовать отправить задачу снова.
Дополнительные ресурсы
- Настройки аккаунта — включение режима песочницы
- CaptchaBotRS на GitHub — приложение для работников
- API документация — справочник по методам и параметрам
- Поддержка — помощь при возникновении вопросов
Контрольный список
- Аккаунт RuCaptcha активен
- Режим песочницы включён в настройках аккаунта
- Определены типы капч для тестирования и их совместимость
- Установлено приложение CaptchaBotRS (для токен-капч)
- Получен и настроен worker key в приложении
- Скрипт отправляет задачи с корректными параметрами
- Реализована обработка ответов и ошибок
- Включено логирование для отладки
- После тестов песочница отключена
Заключение
Режим песочницы RuCaptcha — эффективный способ отладить интеграцию без зависимости от внешних исполнителей. Вы контролируете каждый этап: от отправки задачи до получения ответа, что ускоряет поиск и исправление ошибок.
Помните о ключевых ограничениях: не все типы капч поддерживаются, оплата не списывается в обычном режиме, а после тестов важно вернуть аккаунт в боевое состояние.
Для токен-капч используйте приложение CaptchaBotRS — оно обеспечивает стабильность и удобство, которых нет в веб-интерфейсе. Следите за обновлениями приложения на GitHub, чтобы получать исправления и новые функции.
Когда интеграция готова, отключите песочницу и доверьте решение задач профессионалам RuCaptcha. Обходите любую капчу с помощью наших API.