Найдите причину сбоя запроса

Проверьте HTTP-статус, код ошибки и ответ, затем сверьте версию API, настройки прокси и сессии.

Увеличительное стекло для изучения полей исключений и журналов запросов в ответе API.

Поиск кодов ошибок

31 официальный код ошибки и 9 примеров дополнительных рекомендаций, сгруппированных по типу неисправности. Предложения по обработке необходимо объединить с фактической версией и сообщением.

Параметры и аккаунт

Параметры и учетные записи: код, применимые версии и предложения по устранению неполадок.
Код ошибки/Источник документаРекомендации по устранению неполадокСледующий шаг
PARAMS_ERRORВсе версииответный документ Проверка отсутствия полей, типов и диапазонов, исправление по сообщению; Недопустимые значения тайм-аута в V2 также могут вызвать эту ошибку.Исправить конфигурацию
USER_AGENT_INVALIDv1/v2/v2sответный документ Сначала удалите неразрешенный x-cb-ua или вернитесь к отпечатку пальца по умолчанию и проверьте текущую версию диапазона поддержки UA.Исправить конфигурацию
APIKEY_INVALIDВсе версииответный документ Убедитесь, что фактическая операционная среда прочитала действительный ключ, проверьте статус отключения или сброса и не решайте проблему путем изменения IP-адреса.Прекратить повторную попытку
INSUFFICIENT_BALANCEВсе версииответный документ Запросите баланс баллов API и срок их действия; прокси-трафик — это еще одно использование, и его нельзя заменить друг другом.Прекратить повторную попытку
HOSTNAME_IS_FORBIDDENВсе версииответный документ Проверьте имя целевого домена и права доступа и сохраните сообщение; не пытайтесь обойти явные ограничения доступа.Ручное подтверждение
HOSTNAME_IS_NULLВсе версииответный документ Заполните x-cb-host, укажите только имя целевого хоста и необходимые порты, без параметров протокола, пути или запроса.Исправить конфигурацию
HOSTNAME_IS_INVALIDПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Проверьте целевой хост и порт, сохранив путь и параметры запроса в URL-адресе запроса API.Исправить конфигурацию
PART_ERRORПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Проверьте целочисленный формат x-cb-part и фактический доступный диапазон учетной записи и не используйте случайное повторное использование разделов для других задач.Исправить конфигурацию
INVALID_SITEKEYПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Проверьте ключ сайта Turnstile целевого объекта и убедитесь, что запрос также содержит заполнитель [cf_token].Исправить конфигурацию

Прокси, сеть и сертификаты

Прокси, сети и сертификаты: код, применимые версии и предложения по устранению неполадок
Код ошибки/Источник документаРекомендации по устранению неполадокСледующий шаг
PROXY_ERRORВсе версииответный документ Проверьте учетную запись прокси, протокол, порт, период доступности и трафик и отличайте ошибки, возвращаемые прокси, от ошибок, возвращаемых целевым сайтом.Проверить ссылку
PROXY_FORMAT_ERRORВсе версииответный документ Проверьте формат прокси-сервера в соответствии с документом параметра запроса и убедитесь, что используемая версия принимает протокол; перезапись префикса не означает конвертацию протокола.Исправить конфигурацию
PROXY_IS_FORBIDDENВсе версииответный документ Убедитесь, что адрес прокси-сервера может использоваться службой, и вместо него используйте действительный разрешенный прокси-сервер; не отправляйте один и тот же запрещенный адрес повторно.Прекратить повторную попытку
CONNECTION_ERRORВсе версииответный документ Различайте подключение локального компьютера к API, API к агенту и цели и проверяйте адрес и строку на основе сообщения.Проверить ссылку
DNS_ERRORВсе версииответный документ Сначала подтвердите, является ли сбойное доменное имя локальным доменным именем API, прокси-доменным именем или целевым доменным именем, а затем проверьте разрешение и время ожидания соответственно.Проверить ссылку
TLS_ERRORВсе версииответный документ Проверьте целевые и прокси-протоколы, системное время и цепочку сертификатов; исправлено отсутствие отключения проверки TLS по умолчанию.Проверить ссылку
CERT_ERRORВсе версииответный документ Проверьте цепочку сертификатов, промежуточные сертификаты прокси-сервера и адреса назначения; не связывайте сбои сертификатов просто с проблемами IP.Проверить ссылку
REQUEST_ERRORВсе версииответный документ Тайм-ауты, отклонения и прерывания соединения различаются по сообщению, и только безопасные воспроизводимые временные сбои имеют ограниченное число повторных попыток.Ограниченное количество повторов
EOF_ERRORВсе версииответный документ Проверьте, не закрывается ли соединение преждевременно, не истек ли срок действия прокси-сервера, завершен ли файл, и не рассматривайте усеченные ответы как успех.Проверить ссылку
RESOLVE_PROXYПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Проверьте DNS прокси-сервера с фактической операционной средой и запишите сообщение об ошибке разрешения.Проверить ссылку
PROXY_CONNECT_ABORTEDПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Проверьте аутентификацию прокси, срок действия и причины прерывания соединения и повторите попытку только в рамках бюджета после временного сбоя.Проверить ссылку
TIMEOUT_ERRORПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Различайте ожидание клиента, тайм-аут API и целевой ответ и подтвердите общий бюджет задачи, прежде чем увеличивать тайм-аут.Проверить тайм-аут
SSL_ERRORПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Проверьте цепочки и протоколы сертификатов цели, агента и клиента и не отключайте проверку сертификатов по умолчанию.Проверить ссылку

Проверки и сессии

Проблемы и сеансы проверки: код, применимые версии и предложения по устранению неполадок
Код ошибки/Источник документаРекомендации по устранению неполадокСледующий шаг
UNSUPPORTED_CAPTCHAВсе версииответный документ Сохраните тип проверки и ответ на десенсибилизацию, обратитесь в службу технической поддержки после подтверждения границ поддержки и не повторяйте попытки бесконечно.Прекратить повторную попытку
CLOUDFLARE_PREMIUMv1ответный документ В документации перечислены советы для V1, столкнувшегося с пятисекундными щитами; переключитесь на версию 2 после проверки целей и подготовьтесь к использованию фиксированных или закрепленных прокси.Настроить версию
CLOUDFLARE_CHALLENGE_TIMEOUTv2ответный документ Проверьте стабильность исходящего трафика, достоверность прокси-сервера и двухуровневые тайм-ауты; повторите попытку с бюджетом и при необходимости проверьте новые сеансы.Ограниченное количество повторов
DATADOME_CHALLENGE_TIMEOUTv2ответный документ Проверьте наличие фиксированных/прикрепленных прокси и бюджетов времени испытаний; постоянные сбои сохраняют идентификаторы запросов и выполняются без задержек.Ограниченное количество повторов
DATADOME_ACCESS_DENIEDv2ответный документ Проверьте целевые разрешения, регион и репутацию экспорта; измените разрешенный экспорт в зависимости от основы и одновременно переустановите сеанс.Ручное подтверждение
CHALLENGE_LOCK_TIMEOUTv2ответный документ Проверьте, есть ли еще задачи, ожидающие того же сеанса; wait-lock устарел в текущей документации по параметрам.В первую очередь
CHALLENGE_LOCK_OCCUPIEDv2ответный документ Подождите, пока завершится первый вызов того же сеанса, чтобы уменьшить параллелизм; независимые задачи используют независимые доступные разделы.В первую очередь
BYPASS_ERRORv2ответный документ Сначала прочитайте сообщение и сосредоточьтесь на проверке того, изменился ли агент во время сеанса; сначала создайте новый сеанс, и принудительное использование не будет использоваться в качестве конфигурации по умолчанию.Проверить сеанс
PROXY_NON_STICKYv2ответный документ Эта проверка предназначена только для агента Scrapingbypass API. Вместо этого используйте действительный закрепленный/закрепленный выход и создайте новый сеанс аутентификации.Исправить агент
INCAPSULA_ACCESS_DENIEDПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Проверить целевые лицензии, регионы и экспорт на соответствие фактическим причинам отказа; сохранить доказательства для подтверждения целевой совместимости.Ручное подтверждение

Ограничения сайта и сбои сервиса

Целевые ограничения и исключения для служб: код, применимые версии и предложения по устранению неполадок.
Код ошибки/Источник документаРекомендации по устранению неполадокСледующий шаг
FORBIDDENВсе версииответный документ Сначала проверьте целевые разрешения, статус входа и текст ответа; Рассматривайте V2 только в том случае, если есть четкий запрос на запрос, и не рассматривайте все 403 как подтверждение.Ручное подтверждение
ACCESS_DENIEDВсе версииответный документ Проверьте разрешенные регионы цели, разрешения учетной записи и репутацию экспорта, а также сохраните конкретные доказательства отказа в доступе.Ручное подтверждение
TOO_MANY_REQUESTSВсе версииответный документ Сначала уменьшите параллелизм и соблюдайте действующее правило повторной попытки, проверьте квоты сайта и учетной записи и не полагайтесь на изменение IP-адреса для управления текущим ограничением по умолчанию.Отойди и подожди
BAD_GATEWAYВсе версииответный документ Различать прокси, шлюзы и целевые источники, а также записывать время сбоя и идентификатор запроса; временные сбои можно безопасно отменить и повторить попытку.Ограниченное количество повторов
SERVICE_UNAVAILABLEВсе версииответный документ Проверьте, не являются ли цель или шлюз временно недоступными; контроль повторных попыток в соответствии с установленным сроком и обратная связь после постоянных неудач.Ограниченное количество повторов
SOURCE_SERVER_ERRORВсе версииответный документ Проверьте ответ об ошибке исходного сайта и не изменяйте повторно ненужные параметры; сохранить статус, время и идентификатор запроса.Ограниченное количество повторов
INTERNAL_ERRORВсе версииответный документ Сохраните идентификатор запроса, время и ответ на десенсибилизацию, возвращенный Scrapingbypass API; если проблема продолжает возникать, передайте в службу технической поддержки.поддержка обратной связи
GATEWAY_TIMEOUTПодтвердите фактическим возвратомДополнение к руководству по искусственному интеллекту Определите, является ли это локальным шлюзом, прокси-сервером или восходящим потоком, и подождите истечения времени ожидания, а затем повторите попытку в случае безопасных и воспроизводимых временных сбоев.Ограниченное количество повторов

Источник:данные ответа、Диагностика ошибок доступа к ИИ. Неизвестные ошибки сохраняют свои исходные значения и не классифицируются единообразно как «Изменить IP».

Сначала храните доказательстваРешите, стоит ли пытаться еще раз

01. Есть ли ответ HTTP?

Если ответа нет, сначала проверьте операционную среду, DNS, сеть, сертификат и тайм-аут клиента. Не придумывайте коды ошибок сервера.

02. Прочитайте два уровня результатов

x-cb-status: ok означает, что запрос API обработан успешно; целевой статус, Content-Type и бизнес-контент все равно необходимо проверить.

03. Сохранять поля ошибок

API Ошибка JSON использует идентификатор, код и сообщение. SDK может вызвать исключение, необходимо прочитать фактический ответ.

04. Повторяйте только те запросы, которые можно безопасно воспроизвести.

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

структура ответа на ошибку

{
  "id": "<request-id>",
  "code": "PARAMS_ERROR",
  "message": "<error-message>"
}

Значения полей приведены для справки; сохраняйте фактический ответ при устранении неполадок и не используйте примеры, чтобы скрыть исходные ошибки.

Явление HTTP не равно коду сервисной ошибки Scrapingbypass API.
Наблюдаемая ситуацияОтдавайте предпочтение суждениям
200/HTMLЭто может быть целевой контент, страница входа или страница проверки; сначала проверьте сферы бизнеса.
403Объедините заголовки и тело ответа, чтобы различать проблемы, разрешения учетной записи и региональные ограничения.
429Проверьте ограничение тока и сначала повторите попытку, чтобы уменьшить параллелизм.
5xxРазличайте локальный шлюз, прокси-сервер, целевой источник и ошибки, возвращаемые API.

Посмотреть полное соглашение об ответах

PRT00023 Связь конфигурации между параметрами запроса PRT, выходом прокси и стабильным сеансом

Версии, агенты и сеансыНадо проверить вместе

01. Файлы cookie и части не смешиваются.

Режим файлов cookie сохраняется клиентом и отправляет зашифрованные файлы cookie проверки; Режим детали размещается на сервере. Сеансы проверки части сохраняются в течение 10 минут, в течение которых успешные запросы могут быть продлены, но срок действия агента не будет продлен.

02. Восстановление сеанса после изменений экспорта

Во время испытания сохраняйте согласованность IP-адреса, отпечатка пальца и прокси-сервера; используйте новый сеанс Part или Cookie после изменения выхода и не переключайте прокси одновременно в одном и том же разделе.

03. Блокировки сеансов ставятся в очередь первыми

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

Проверка версии интерфейса, прокси и таймаута
версияЗапросы и сеансыx-cb-timeout
V1По умолчанию он поставляется с динамическим прокси; каждый запрос не имеет состояния. x-cb-proxy можно настроить по мере необходимости.По умолчанию 30 секунд; 5–3600 секунд для Go V1. Недопустимые значения можно игнорировать.
V2ПРТ00014ПРТ: 2; Должен быть предоставлен фиксированный или зависящий от времени прокси-сервер. Выберите режим «Cookie» или «Частичный».Значение по умолчанию — 15 секунд; текущий Python V2 составляет 5–360 секунд, а недопустимые значения возвращают PARAMS_ERROR.
V2sx-cb-version: 2 с; соответствует требованиям к прокси-серверу и сеансу V2, поддерживает потоковую передачу ответа HTTP.По умолчанию 30 секунд; диапазон 5–3600 секунд. Клиентам по-прежнему необходимо настроить собственный бюджет ожидания.
Запутанная конфигурация запроса
КонфигурацияЧто стоит проверить
URL и x-cb-hostURL-адрес API сохраняет целевой путь и параметры запроса; x-cb-host заполняет имя целевого хоста и необходимые порты, но не заполняет протокол или путь.
x-cb-protocolЯвно установлено значение http, если целью является HTTP; по умолчанию используется https, если он не установлен.
x-cb-proxyЭто выход, когда служба API обращается к цели, и он не эквивалентен настройке прокси-сервера для локального клиента HTTP. Проверьте сертификаты, соглашения, доступность и стабильность экспорта.
x-cb-partТолько V2/V2s; Диапазон документа по умолчанию — целое число от 0 до 998, фактический диапазон зависит от ограничений службы. Изолируйте разделы для разных задач.
x-cb-sitekeyTurnstile необходимо предоставить с заполнителем [cf_token] или %5Bcf_token%5D; JS-запрос не требует заполнения sitekey.
x-cb-fp / x-cb-uaСравните отпечаток фактической версии с поведением UA. В настоящее время Python V2 игнорирует x-cb-ua и не объединяет номера версий браузера случайным образом.
Перенаправления и параметры конфигурацииПеренаправления обрабатываются по умолчанию; см. «Отключить-перенаправление», если вам нужно проверить наличие 3xx и Set-Cookie. wait-lock устарел, ignore-lock и Force не используются в качестве патчей по умолчанию.
Тайм-ауты и повторные попыткиДействительный x-cb-timeout имеет приоритет над длительным тайм-аутом. Крайние сроки клиента, SDK, агента и задачи проверяются отдельно, чтобы избежать наложения нескольких уровней автоматических повторов.

Существуют различия в описаниях протокола прокси на странице параметров и странице ответа, которые необходимо проверить на основе используемой версии и фактического сообщения; полные поля, доступные диапазоны и различия в реализации следующие:Последняя документация по параметрам запросабудет преобладать.

V2s — это потоковый ответ, а не официальная фоновая задача, интерфейс опроса или обратного вызова. Загрузки должны проверять статус назначения, тип контента и целостность; ни 200, ни существование файла недостаточно для доказательства успеха.

Документы и инструменты, вход найти по вопросу

Начало работы и отзывчивость

SDK и доступ к ИИ

Инструменты и коллекционеры

Выставление счетов, пробная версия и границы возможностей

Баллы, баланс и различия в конфигурации SDK

Сначала различайте точки API и прокси-трафик.

Официальное описание документа: Успешный запрос потребляет 1 балл, а каждый успешный вызов проверки V2 требует дополнительных 2 балла; многоэтапная проверка оплачивается отдельно. Если последующий ответ после успешного ответа неправильный, уже списанные баллы вызова не будут возвращены, но баллы запроса не будут вычтены за неудавшийся ответ. SDK Автоматическое отслеживание ответов на перенаправление также потребляет баллы.

Интерфейс баланса POST https://console.cloudbypass.com/api/v1/balance, используя поле JSON apikey、email、type。points Контрольные точки и срок годности,res / dat Запрос трафика жилого помещения/компьютерного зала, единица измерения – байты. Старый запрос GET устарел и не помещает учетные данные в URL-адрес.

SDK имеет различные соглашения о переменных среды: Python / использование документации Go. CB_APIKEY、CB_PROXY;PRT00039Приоритетное чтение PRT CLOUDBYPASS_APIKEY、CLOUDBYPASS_PROXY, прочитайте еще раз, когда пусто CB_*. Переменные в руководстве AI не появляются автоматически в каждой среде SDK или удаленной среде MCP.

И инструмент локального агента, и Nginx используют методы переадресации доступа; ключ хранится в доверенной операционной среде, а объем мониторинга и права доступа необходимо контролировать. Документация явно не поддерживает использование непосредственно в браузерах отпечатков пальцев Selenium/Puppeteer, а также не поддерживает ws/wss для WebSocket и не путает потоковые ответы HTTP с этими возможностями.

Часто задаваемые вопросы и доказательства обратной связи

HTTP 200 означает, что миссия прошла успешно?

Нет. Сначала проверьте x-cb-status, затем проверьте целевой статус HTTP, Content-Type и бизнес-поля. x-cb-status: ok означает, что запрос Scrapingbypass API обработан успешно, но это не означает, что необходимо завершить вход в систему, размещение заказа или сохранение файлов и другие услуги.

При отсутствии ответа HTTP код ошибки сервера Scrapingbypass API не может быть сфабрикован. Сначала проверьте локальные зависимости, операционную среду, DNS, сеть, сертификат и тайм-аут клиента; после получения ответа прочитайте фактический идентификатор, код и сообщение.

Номер 403 также может исходить из учетной записи без разрешений, региональных ограничений или целевых бизнес-правил. Когда V1 явно запросит CLOUDFLARE_PREMIUM или вернет информацию, запрашивающую V2, настройте V2 и стабильный агент; обычные ошибки разрешений не исчезнут автоматически благодаря обновленным версиям.

В документации по быстрому запуску указано, что вызов DataDome автоматически распознается V2 без необходимости использования дополнительного специального заголовка DataDome. Фиксированный или закрепленный x-cb-proxy по-прежнему должен быть настроен и использовать соответствующие сеансы cookie или части; целевая совместимость требует фактической проверки.

x-cb-sitekey также должен соответствовать [cf_token] или его заполнителю в URL-адресе, заголовке или теле запроса. Scrapingbypass API заменяет заполнитель и перенаправляет целевой запрос вместо того, чтобы передавать голый токен непосредственно клиенту в качестве общего возвращаемого значения.

В документации различаются точки запроса и точки проверки: успешный запрос потребляет 1 балл, а V2 — дополнительные 2 балла за каждый успешный запрос проверки. Если последующий ответ неверен после успешного ответа, вычтенные баллы вызова не будут возвращены, но баллы запроса не будут вычтены за неудавшийся ответ; многоступенчатая проверка рассчитывается поэтапно.

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

Нет необходимости. Просто укажите время и часовой пояс, идентификатор запроса, цель десенсибилизации, версию, код/сообщение, регион и тип прокси-сервера и попытайтесь записать. Не отправляйте ключ API, пароль прокси-сервера, файлы cookie для входа, полное тело запроса или параметры запроса с помощью токена.

Организуйте записи времени возникновения, реакции на ошибки и диагностики и передайте их в службу технической поддержки.

Сохраните эту информацию при обращении в службу поддержки.

  • Время возникновения и часовой пояс, идентификатор запроса
  • Цель десенсибилизации, версия API, статус HTTP
  • x-cb-status, исходный код и десенсибилизированное сообщение.
  • Тип агента, регион, срок действия и режим сеанса
  • Опробованные шаги и окончательный результат

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

Сценарии доступа и использования ИИ

Пробная акция
+ 200 API-кредитов
+ Прокси-трафик
Получить сейчас ›