Частые вопросы по Cloudbypass API
Как рассчитывается списание баллов по тарифу?
Cloudflare и DataDome используют общий баланс API-кредитов, единые правила списания и цены. Выберите тариф по объёму использования; трафик прокси оплачивается отдельно.
V1 и V2(s) списывают 1 API-кредит за каждый успешный запрос.
Если V2(s) успешно проходит проверку, дополнительно списываются 2 кредита. Это относится к поддерживаемым проверкам Cloudflare JS Challenge, Cloudflare Turnstile, DataDome и Incapsula.
При неуспешном запросе базовый кредит не списывается. Однако 2 кредита за проверку списываются сразу после её успешного завершения и не возвращаются, если последующий ответ завершился ошибкой.
Повторное использование действующей сессии сокращает число проверок, но каждый успешный запрос по-прежнему стоит 1 кредит. Последующие запросы в сессии не бесплатны.
Используйте кредиты до окончания срока тарифа. У каждого пакета свой срок действия; сначала расходуются кредиты с ближайшей датой истечения.
Как работает Cloudbypass API?
Используйте стандартные HTTP-запросы, общую логику интеграции и код для Cloudflare и DataDome, сохраняя существующий фреймворк сбора данных. Сохраняйте IP прокси, cookies и сессию и проверяйте статус и содержимое ответа. Поддержка зависит от сайта и типа проверки. Сначала проверьте совместимость: общий тариф не гарантирует доступ к любому сайту.
Как использовать Cloudbypass API? Есть примеры кода?
Cloudflare и DataDome используют одну логику интеграции API и один подход к коду запросов.
Передайте нам тело HTTP-запроса для целевого сайта — мы полностью перенаправим его на x-cb-host.
Используйте генератор кода для создания фрагментов cURL, JavaScript, TypeScript, Java и Python.
Примеры для Cloudbypass API и прокси-сети: посмотреть
В чем разница между версиями V1 и V2(s)?
V2(s) обрабатывает JS-опрос и рендеринг.
В V2(s) нет прокси по умолчанию — требуется покупка прокси-сети. В V1 включены ротационные прокси.
Что означает разделение сессий в V2(s)?
Разделы сессий управляют Cookie Cloudflare. После проверки сессия активна 10 минут без смены прокси и отпечатка, чтобы не запускать новую проверку. Управление учетными сессиями — на стороне пользователя.
Доступно до 1000 разделов (0–999). Успешные запросы продлевают блокировку на 10 минут.
Как выбрать V1 или V2(s) для прохождения проверки?
Протестируйте URL в генераторе кода, начните с V1.
Если не проходит, используйте V2(s) и настройте прокси. Мы предоставляем тестовый трафик; извлеките IP в панели прокси-сети. Рекомендуемый срок — от 10 минут.
Какой максимальный параллелизм запросов?
Во всех тарифах максимальная параллельность — 30 запросов в секунду.
Сообщение: "code":"INSUFFICIENT_BALANCE"
INSUFFICIENT_BALANCE означает отсутствие баллов Cloudbypass API.
Пополните баланс в панели: https://console.cloudbypass.com/#/api/login или свяжитесь с поддержкой для тестовых баллов.
Сообщение: "code": "CHALLENGE_LOCK_OCCUPIED"
Описание:
"code": "CHALLENGE_LOCK_OCCUPIED"
"message": "The current part is being challenged, please wait for the lock to be released."
Причины:
Один и тот же part используется несколькими потоками.
Несколько пользователей работают с одним part.
Предыдущий запрос удерживает блокировку из-за таймаута или прерывания.
Решение:
Дождаться освобождения блокировки и повторить запрос.
Изменить part (диапазон 0–999).
Сообщение: "code": "FORBIDDEN", "message": "V3 Challenge Failed"
Решение:
1) Установите срок IP не менее 10 минут.
2) Смените страну IP. Используйте ротацию по разным регионам, один регион чаще ограничивается.
Почему при веб-скрейпинге появляются 403, 503 или Access Denied?
Чаще всего требуется настройка прокси-сети. Используйте режим API или прокси-режим. Для локальных пользователей рекомендуется режим API. Поддерживаются прокси по HTTP.
Поддерживаются ли Selenium или Puppeteer?
Пока не поддерживаются Selenium и Puppeteer. Сервис эмулирует HTTP-запросы без запуска браузера.
