Распознавание капчи

Модуль распознавания получает изображение или параметры браузерного задания, отправляет их выбранной службе и помещает готовый ответ в |AGRESULT|. Для устойчивого проекта нужно заранее определить вид задания, источник адреса страницы и ветку ошибки.

Порядок работы

Команды модуля

|AGRESULT| принадлежит текущему запросу. Следующий запрос или завершение текущего очищает связь с ответом и идентификатором задания, поэтому не используйте старое решение как постоянную динамическую переменную.

Прокси при распознавании

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

• 2Captcha и RuCaptcha принимают HTTP, SOCKS4 и SOCKS5 в поддерживаемых заданиях;
• Anti-Captcha получает поддерживаемый прокси в полях задания;
• DeathByCaptcha принимает HTTP для своего потока заданий;
• reCAPTCHA 3 в поддерживаемых ветках отправляется без прокси задания;
• XEvil использует форму той службы, которую он имитирует;
• учётные данные прокси не записываются в диагностический журнал.

Виды заданий

https://example.test/captcha/image.png

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...

<svg xmlns="http://www.w3.org/2000/svg" width="120" height="40">
  <text x="10" y="25">A7K9</text>
</svg>

Заголовки изображения

|AGHEADERS|...|AGHEADERS| записывается в поле дополнительных заголовков и передаёт выделенные строки при загрузке картинки по ссылке.

accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
accept-encoding:gzip, deflate, br
|AGHEADERS|Accept-Language:ru-RU,ru;q=0.8,en-US;q=0.6,en;q=0.4|AGHEADERS|

Обычные заголовки относятся к запросу проекта. Заголовки внутри |AGHEADERS| дополнительно применяются к получению изображения капчи.

Дополнительная ссылка запроса

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

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

Параметры службы

Дополнительные параметры передаются строкой, где пары разделяются символом &:

numeric=2&is_russian=1

Параметр regsense в in-Line Kit по умолчанию равен 1. Добавляйте только параметры, которые поддерживает выбранная служба; их текущий состав описан в справочнике Anti-Captcha и справочнике RuCaptcha.

Для CapMonster отключите настройку «Получение ответа с задержкой», если задание ещё не готово. Это требование относится к CapMonster, а не ко всем местным заменителям служб.

Результат и ошибки

При успехе ответ преобразуется в UTF-8, кодируется для безопасной подстановки в адрес и становится доступен как |AGRESULT|. Повторное кодирование перед вставкой в данные запроса обычно исказит ответ.

Если результат распознавания содержит префикс ERROR_, Private Keeper:

1. записывает технический ответ службы в журнал;
2. останавливает дальнейшие запросы текущей ветки;
3. устанавливает результат |CONCLUSION| = 3 — капча или блокировка.

То же итоговое состояние используется, когда ключ службы не введён или распознавание отключено. Не пытайтесь разобрать ERROR_ в следующем обычном запросе: этот запрос уже не будет выполнен. Обработайте результат 3 в структуре проекта и сохраните журнал для диагностики.

Неверный ответ службы

Если сайт явно сообщил, что распознанное значение неверно, добавьте к соответствующему определению |AGREPORT|. Жалоба относится к текущему активному заданию и отправляется только один раз.