Error zero captcha filesize - Исправление ошибок и поиск оптимальных решений проблем

Home
BrowserAutomationStudio
Поддержка
С чём может быть связана ошибка ERROR_ZERO_CAPTCHA_FILESIZE ?

This topic has been deleted. Only users with topic management privileges can see it.

Появилась капча (текстовая), решал через anti-captcha
@WasTabon said in С чём может быть связана ошибка ERROR_ZERO_CAPTCHA_FILESIZE ?:

Появилась капча (текстовая), решал через anti-captcha

Ну текст ошибки говорит, что вы не отправляете картинку на решение, а отправляете пустой файл
@Fox Ага, значит типо вместо капчи там появилось — ничего?
@WasTabon said in С чём может быть связана ошибка ERROR_ZERO_CAPTCHA_FILESIZE ?:

@Fox Ага, значит типо вместо капчи там появилось — ничего?

Проверьте селектор капчи, скорее всего проблема в нём
@Fox И как это решить? Просто ожидание добавить?
Вроде нормальный, типо css > чёто-там
@WasTabon said in С чём может быть связана ошибка ERROR_ZERO_CAPTCHA_FILESIZE ?:

@Fox И как это решить? Просто ожидание добавить?
Вроде нормальный, типо css > чёто-там

Если у вас селектор не верный, значит создайте правильный селектор. Если капча не успевает прогрузиться, то используйте действие «Ждать Появления Элемента«

5

0
Votes

5
Posts

3134
Views
1

0
Votes

1
Posts

79
Views
6

0
Votes

6
Posts

589
Views
6

0
Votes

6
Posts

1188
Views
12

0
Votes

12
Posts

2930
Views
10

0
Votes

10
Posts

1320
Views
3

0
Votes

3
Posts

122
Views
3

0
Votes

3
Posts

715
Views

Вверх ↑

ФорумыМежду деломPOST и GET запрос на https://rucaptcha.com/
← Ctrl12Ctrl →

#1: 2017-12-07 11:19:53 ЛС \| профиль \| цитата
POST и GET запрос на https://rucaptcha.com/ Привет всем, Доброго времени суток. Народ, если кто сталкивался, помогите отправить капчу на сервис rucaptcha.com методом POST. Делаю вроде-бы всё как написано в ruCaptcha.com API (https://rucaptcha.com/api-rucaptcha#solving_normal_captcha). А в ответ всё равно выдаёт ERROR_WRONG_USER_KEY, т.е. не принемает ключ! Заранее очень всем благодарен!
карма: 2

Google

vip

#1.1контекстная реклама от партнеров

Ответов: 4596

Рейтинг: 738

#2: 2017-12-07 12:19:30

ЛС |
профиль |
цитата

PostData принимаются в формате application/x-www-form-urlencoded, то есть, в виде field1=value1&field2=value2.

Твои должны выглядеть примерно так:

method=post&key=06a0e455d106be20e0d21f7faf3d45f1&file=<а вот тут затык — файлы по application/x-www-form-urlencoded не передаются>

Редактировалось 2 раз(а), последний 2017-12-07 12:56:32

карма: 26

Ответов: 284

Рейтинг: 4

#3: 2017-12-07 12:46:50

ЛС |
профиль |
цитата

Netspirit, а если всё это отправлять не в multipart, а в base64, получится?

Этот метод тоже описан: https://rucaptcha.com/api-rucaptcha#solving_normal_captcha

карма: 2

Ответов: 4596

Рейтинг: 738

#4: 2017-12-07 12:57:50

ЛС |
профиль |
цитата

Используй HTTPClient:

Method=POST

POSTParams.PostData=

method=post

key=06a0e455d106be20e0d21f7faf3d45f1

POSTParams.FileField=file

POSTParams.UploadFile=путь к загружаемому файлу

Sova-Kmv писал(а):

а в base64, получится?

Может получиться.

method=base64&key=06a0e455d106be20e0d21f7faf3d45f1&body=<строка в Base64>

Редактировалось 5 раз(а), последний 2017-12-07 13:50:23

карма: 26

Ответов: 284

Рейтинг: 4

#5: 2017-12-07 13:30:41

ЛС |
профиль |
цитата

Netspirit, ща попробуем!

— Добавлено в 2017-12-07 14:11:01

Netspirit, при скачивании элемента, качается какой-то не извесный фал, да-же без расширения!

— Добавлено в 2017-12-07 14:17:59

Какой-то Http и Http1

Редактировалось 2 раз(а), последний 2017-12-07 14:17:59

карма: 2

Ответов: 284

Рейтинг: 4

#6: 2017-12-07 14:36:47

ЛС |
профиль |
цитата

Во-блин!, а через HiAsm весь архив нормально скачался!

карма: 2

Ответов: 4596

Рейтинг: 738

#7: 2017-12-07 15:06:34

ЛС |
профиль |
цитата

Там с каким-то из браузеров, по-моему, такая лажа происходит.

карма: 26

Ответов: 284

Рейтинг: 4

#8: 2017-12-07 15:10:36

ЛС |
профиль |
цитата

[b]Netspirit[/b], ну взгляни пожалуйста, что-то ничего не выходит.

Редактировалось 1 раз(а), последний 2017-12-07 15:13:21

карма: 2

Ответов: 4596

Рейтинг: 738

#9: 2017-12-07 15:15:23

ЛС |
профиль |
цитата

Смотри что указал в свойствах FileField и UploadFile. Там долно быть «file» и путь к файлу соответственно.

карма: 26

Ответов: 284

Рейтинг: 4

#10: 2017-12-07 15:45:22

ЛС |
профиль |
цитата

Netspirit, Не могу разобраться, что-то в свойствах FileField не так.

Мудрил по разному!

Теперь пишет: ERROR_ZERO_CAPTCHA_FILESIZE

Редактировалось 1 раз(а), последний 2017-12-07 15:50:46

карма: 2

Ответов: 4596

Рейтинг: 738

#11: 2017-12-07 15:50:17

ЛС |
профиль |
цитата

FileField равно «file» (без кавычек)?

карма: 26

Ответов: 284

Рейтинг: 4

#12: 2017-12-07 15:53:30

ЛС |
профиль |
цитата

Netspirit, и так пробовал.

file C:UsersНиколайDesktopsecurimage_show.php.png

Пишет: ERROR_ZERO_CAPTCHA_FILESIZE

Редактировалось 1 раз(а), последний 2017-12-07 15:54:43

карма: 2

Ответов: 4596

Рейтинг: 738

#13: 2017-12-07 16:25:25

ЛС |
профиль |
цитата

Само собой разумеется, файл «C:UsersНиколайDesktopsecurimage_show.php.png» должен существовать.

Редактировалось 1 раз(а), последний 2017-12-07 16:26:26

карма: 26

Ответов: 284

Рейтинг: 4

#14: 2017-12-07 16:49:35

ЛС |
профиль |
цитата

Netspirit, прикинь, а если слово file заменить на File, то тоже не работает!

карма: 2

Ответов: 4596

Рейтинг: 738

#15: 2017-12-07 16:52:45

ЛС |
профиль |
цитата

А что, кто-то обещал регистронезависимость в этом месте? Так у них реализовано. Так что, моя схема работает?

Редактировалось 1 раз(а), последний 2017-12-07 16:53:15

карма: 26

ФорумыМежду деломPOST и GET запрос на https://rucaptcha.com/
← Ctrl12Ctrl →

Источник

private function GetCaptchaAPI($filename, $apikey, $is_verbose = true, $rtimeout = 5, $mtimeout = 120, $is_phrase = 0, $is_regsense = 0, $is_numeric = 1, $min_len = 0, $max_len = 0) { // функция получения каптчи с сервиса antigate.com

$filename — полный путь к файлу

$apikey — ключ для работы

$rtimeout — задержка между опросами статуса капчи

$mtimeout — время ожидания ввода капчи

включить/выключить verbose mode (комментирование происходящего):

$is_verbose — false(выключить), true(включить)

дополнительно (дефолтные параметры править не нужно без необходимости):

$is_phrase — 0 либо 1 — флаг «в капче 2 и более слов»

$is_regsense — 0 либо 1 — флаг «регистр букв в капче имеет значение»

$is_numeric — 0 либо 1 — флаг «капча состоит только из цифр»

$min_len — 0 (без ограничений), любая другая цифра указывает минимальную длину текста капчи

$max_len — 0 (без ограничений), любая другая цифра указывает максимальную длину текста капчи

пример:

$text=recognize(«/path/to/file/captcha.jpg»,»ваш_ключ_из_админки»,true);

$text=recognize(«/path/to/file/captcha.jpg»,»ваш_ключ_из_админки»,false); //отключено комментирование

$text=recognize(«/path/to/file/captcha.jpg»,»ваш_ключ_из_админки»,false,1,0,0,5); //отключено комментирование, капча состоит из двух слов, общая минимальная длина равна 5 символам

if (!file_exists($filename))

{

if ($is_verbose) echo «file $filename not foundn»;

return false;

}

$postdata = array(

‘method’ => ‘post’,

‘key’ => $apikey,

‘file’ => ‘@’.$filename, //полный путь к файлу

‘phrase’ => $is_phrase,

‘regsense’ => $is_regsense,

‘numeric’ => $is_numeric,

‘min_len’ => $min_len,

‘max_len’ => $max_len,

);

if (!$ch=curl_init()) trigger_error(«Couldn’t initialize a cURL handle», E_USER_ERROR );

curl_setopt($ch, CURLOPT_URL, ‘http://www.anti-captcha.com/in.php’);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

curl_setopt($ch, CURLOPT_TIMEOUT, 60);

curl_setopt($ch, CURLOPT_POST, 1);

curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata);

$result = curl_exec($ch);

if (curl_errno($ch)) {

if ($is_verbose) echo «CURL returned error: «.curl_error($ch).«n»;

return false;

}

curl_close($ch);

if (strpos($result, «ERROR»)!==false) {

if ($is_verbose) echo «server returned error: $resultn»;

return false;

} else {

$ex = explode(«|», $result);

$captcha_id = $ex[1];

if ($is_verbose) echo «captcha sent, got captcha ID $captcha_idn»;

$waittime = 0;

if ($is_verbose) echo «waiting for $rtimeout secondsn»;

sleep($rtimeout);

while(true) {

$result = file_get_contents(‘http://anti-captcha.com/res.php?key=’.$apikey.‘&action=get&id=’.$captcha_id);

if (strpos($result, ‘ERROR’)!==false) {

if ($is_verbose) echo «server returned error: $resultn»;

return false;

}

if ($result==«CAPCHA_NOT_READY») {

if ($is_verbose) echo «captcha is not ready yetn»;

$waittime += $rtimeout;

if ($waittime>$mtimeout) {

if ($is_verbose) echo «timelimit ($mtimeout) hitn»;

break;

}

if ($is_verbose) echo «waiting for $rtimeout secondsn»;

sleep($rtimeout);

} else {

$ex = explode(‘|’, $result);

if (trim($ex[0])==‘OK’) return trim($ex[1]);

}

return false;

}

} /* ————————— */

Источник

My problem is simple. No captcha solver seems to work. I have in particular with captcha v3 this error message, which I do not understand you much I admit.

I have attached 3 images which I think are useful for reporting this error, here for a v3 captcha. Do you see where the problem could be?

Ok thank you, I’m new to the software and didn’t quite understand the meaning of this. It is therefore necessary to opt for a paid solution, for those who are asking the same question as me. Thank you

@SotkaDaily omg насколько у вас БАС устаревший. Вот объясните мне, вам так сложно обновиться? Это могло звучать как предъява, но нет, мне просто интересно: в чём причина, что некоторые на таких допотопных версиях сидят?

@DoctorKrolic с каждой версией бас ест больше ресурсов. больше идей нет

PostData принимаются в формате application/x-www-form-urlencoded, то есть, в виде field1=value1&field2=value2.

Netspirit, ща попробуем!

— Добавлено в 2017-12-07 14:11:01

Netspirit, при скачивании элемента, качается какой-то не извесный фал, да-же без расширения!

— Добавлено в 2017-12-07 14:17:59

Какой-то Http и Http1

Редактировалось 2 раз(а), последний 2017-12-07 14:17:59

Источник

Error wrong user key

Сегодня целый день так. Если капча в плагине винки, то она не найдена. В аккаунте антигейта пишется, что неопределенных капч нет. За то сам скрипт не определяет ни одну капчу. Целый день потратил на 2 маленьких проекта, уже и менял айпишку на много разных стран, бесполезно.

1. Читайте новости. (Про атаку)

2. Смотрите «Загрузка системы». Увеличивайте ставки за 1000

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

код количество описание ошибки

ERROR_WRONG_USER_KEY 0 Ваш софт шлет неправильный ключ API

ERROR_KEY_DOES_NOT_EXIST 0 Ваш софт шлет неправильный ключ API

ERROR_NO_SLOT_AVAILABLE 0 Система перегружена капчами. Вы можете попробовать увеличить вашу ставку за 1000 капч (меню СТАВКИ) чтобы избавиться от этой ошибки.

ERROR_ZERO_CAPTCHA_FILESIZE 0 Размер капчи, которую вы прислали, равен 0 байтам. Обратитесь к разработчику вашего софта за разъяснениями.

ERROR_TOO_BIG_CAPTCHA_FILESIZE 0 Слишком большой размер капчи. Максимум равен 100,000 байт.

ERROR_WRONG_FILE_EXTENSION 0 Расширение файла либо не указано, либо не равно одному из следующих: jpg, gif или png

ERROR_IMAGE_IS_NOT_PNG 0 Капча не является корректным PNG файлом

ERROR_IMAGE_IS_NOT_JPEG 0 Капча не является корректным JPEG файлом

ERROR_IMAGE_IS_NOT_GIF 0 Капча не является корректным GIF файлом

ERROR_URL_METHOD_FORBIDDEN 0 метод URL более не поддерживается

ERROR_ZERO_BALANCE 0 У вас нулевой баланс и система не приняла ваши капчи. Необходимо пополнить баланс для продолжения работы.

ERROR_IP_NOT_ALLOWED 0 Был получен запрос на обработку капчи с IP, который отсутствует в списке разрешенных IP

ERROR_CAPTCHA_UNSOLVABLE 0 Капча которую вы загрузили наши работники не смогли распознать

ERROR_BAD_DUPLICATES 0 достигнут лимит дублирующих капч (для функции 100% распознавание)

Источник

ruCaptcha— это сервис для автоматического распознавания изображений. Сервис позволяет решать капчу, а также конвертировать в текст любые изображения, которые может распознать человек. API сервиса позволяет быстро и легко автоматизировать выполнение этих задач.

Мы предоставляем программный интерфейс (API), который позволяет интегрировать ваше программное обеспечение с нашим сервисом и автоматизировать процесс распознавания изображений и решения капчи.

Процесс распознавания изображений и решения капчи состоит из нескольких простых шагов:

Вы отправляете изображение на наш сервер.
Сервер возвращает вам уникальный идентификатор вашей задачи (Captcha ID).
Вы запускаете цикл, который проверяет, выполнена ли задача.
Сервер возвращает вам результат распознавания.

7 декабря 2022

13 октября 2022

Временно убрана поддержка капчи TikTok

7 сентября 2022

29 июля 2022

24 марта 2022

5 июля 2021

Добавлена поддержка домена recaptcha.net для reCAPTCHA

1 июня 2021

Добавлена поддержка rqdata для hCaptcha

22 декабря 2020

1 сентября 2020

Добавлен метод для решения reCAPTCHA Enterpise

27 июля 2020

Добавлен метод для решения капчи TikTok

1 июня 2020

29 мая 2020

Добавлена поддержка data-s, cookies и userAgent для reCAPTCHA V2

10 сентября 2019

4 июля 2019

Добавлена поддержка параметра surl для FunCaptcha

18 июня 2019

31 мая 2019

Добавлен метод ReportGOOD и мы рекомендуем всем его использовать. Подробнее

11 февраля 2019

Добавлен метод для Geetest капчи. Подробнее

1 февраля 2019

Добавлен метод для отладки. Подробнее

14 декабря 2018

Добавили описание API для reCAPTCHA V3 Подробнее

21 сентября 2018

Обновили логику pingback. Теперь нужно регистрировать только домен/IP вместо полного URL. Подробнее

17 апреля 2018

Добавлен новый параметр для расширенной поддержки языков. Подробнее

18 января 2018

Добавлен новый параметр для невидимой reCAPTCHA. Подробнее

17 января 2018

Добавлен новый метод для FunCaptcha! Описание метода

25 декабря 2017

Метод KeyCaptcha снова доступен! Описание метода здесь.

12 декабря 2017

Метод AudioCaptha более не поддерживается.

27 февраля 2017

Добавлены рекомендации по решению невидимой reCAPTCHA. Больше информации здесь.

24 ноября 2016

Добавлены новые коды ошибок, связанные с ограничениями на запросы к сервису. Больше информации здесь.

9 ноября 2016

Добавлены новые примеры кода для решения reCAPTCHA V2. Вы можете найти их здесь.

9 ноября 2016

В настоящее время мы можем решить reCAPTCHA V2 на любом сайте. От вас требуется прислать полный URL страницы, на которой нужно решить reCAPTCHA (ранее это не требовалось). Отправка информации о прокси не обязательная, но мы рекомендуем это делать.

Наши тарифы доступны на странице Тарифы

Вы можете ознакомиться с примерами решения различных видов капчи на PHP, Java и Python на нашей Демо странице.

Наш API построен на HTTP-запросах и поддерживает как протокол HTTP, так и HTTPS.

Адреса API:

http://rucaptcha.com/in.php используется для отправки капчи
http://rucaptcha.com/res.php используется для получения ответа на капчу

Алгоритм решения капчи с помощью нашего сервиса достаточно прост и практически одинаков для всех видов капчи.

Получите ваш персональный ключ API в настройках вашего аккаунта. Для каждого пользователя генерируется уникальный аутентификационный токен, мы называем «персональный ключ API». Это строка из 32 символов, которая выглядит примерно так:
1abc234de56fab7c89012d34e56fa7b8
Этот ключ используется для всех ваших запросов к серверу.
Отправьте запрос HTTP POST на URL нашего API:
http://rucaptcha.com/in.php
с персональным ключом API и параметрами, соответствующеми виду вашей капчи.
Сервер вернёт идентификатор вашей капчи или код ошибки, если что-то пошло не так.
Подождите 5 секунд (для reCAPTCHA — 20 секунд ).
Отправьте запрос HTTP GET на URL нашего API:
http://rucaptcha.com/res.php
с персональным ключом API и полученным ранее идентификатором капчи, чтобы получить результат.
Если ваша капча уже решена, сервер вернёт ответ на неё в формате, соответстующем виду капчи.
По умолчанию сервер возвращает ответ как простой текст, например: OK|ТЕКСТ. Ответ также можно получить в формате JSON , для этого нужно использовать параметр json.
Если ваша капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.
Если с вашим запросом что-то не так, сервер вернёт код ошибки.

Обычная капча — это изображение, на котором размещён искажённый текст, который может быть прочитан человеком. Чтобы решить капчу, нужно ввести текст с изображения.

Чтобы решить нормальную капчу с помощью нашего сервиса, вам необходимо загрузить изображение с помощью HTTP POST запроса к URL нашего API:
http://rucaptcha.com/in.php
Сервер принимает изображения в формате multipart или base64.

Пример multipart-формы

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

Пример base64-формы

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

BASE64_FILE — тело файла капчи в формате base64.

Вы можете указать дополнительные параметры в вашем запросе, чтобы определить, какой тип капчи вы решаете и помочь нашим работникам решить её правильно. Полный список параметров приведён в таблице ниже.

Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например:
OK|2122988149
или в формате JSON:

если вы использовали параметр json в запросе.

Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

Подождите 5 секунд и отправьте HTTP GET запрос к URL нашего API:
http://rucaptcha.com/res.php
с персональным ключом API и полученным ранее идентификатором капчи, чтобы получить результат. Список параметров для запроса приведен в таблице ниже.

Если ваша капча уже решена, сервер вернёт ответ на неё в виде простого текста, например:
OK|TEXT
или в формате JSON

если вы использовали параметр json.

Если ваша капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт ошибку, описание которой можно найти в главе Обработка ошибок.

Список параметров POST-запроса к http://rucaptcha.com/in.php

POST параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да post — говорит о том, что вы отправляете изображение с помощью multipart-фомы
base64 — говорит о том, что вы отправляете изображение в формате base64

file Файл Да* Файл изображения.
* — обязателен, если вы отправляете картинку как файл (method=post)

body Строка Да* Изображение, закодированное в формат Base64,
* — обязателен, если вы отправляете картинку в Base64 (method=base64)

phrase Число
По умолчанию: 0 Нет 0 — капча состоит из одного слова
1 — капча состоит из двух или более слов

regsense Число
По умолчанию: 0 Нет 0 — капча не чувствительна к регистру
1 — капча чувствительна к регистру

numeric Число
По умолчанию: 0 Нет 0 — не определено
1 — капча состоит только из цифр
2 — капча состоит только из букв
3 — капча состоит либо только из букв, либо только из цифр
4 — в капче ДОЛЖНЫ быть и буквы, и цифры

calc Число
По умолчанию: 0 Нет 0 — не определено
1 — капча требует совершения математического действия (например: напишите результат 4 + 8 = )

min_len Число
По умолчанию: 0 Нет 0 — не определено
1..20 — минимальное количетсво символов в ответе

max_len Число
По умолчанию: 0 Нет 0 — не определено
1..20 — максимальное количетсво символов в ответе

language Число
По умолчанию: 0 Нет 0 — не определено
1 — капча содержит только кириллицу
2 — капча содержит только латиницу

lang Строка Нет Код языка. См. список поддерживаемых языков.

textinstructions Строка
Максимум 140 символов
Кодировка: UTF-8 Нет Текст будет показан работнику, чтобы помочь ему правильно решить капчу.
Например: введите только красные буквы.

imginstructions Изображение
Макс. 450x150px, 100 Кбайт Нет Изображение будет показано работнику, чтобы помочь ему решить капчу правильно.
Сервер принимает изображения в формате multipart или base64.

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример запроса:

Текстовая капча — это капча, которая не содержит изображений и представлена в виде простого текста. Обычно для решения нужно ответить на какой-либо вопрос.

Например: «Если завтра суббота, то какой сегодня день?».

Чтобы решить этот вид капчи с помощью нашего сервиса, вам нужно передать текст в параметре textcaptcha в POST-запросе к нашему API:
http://rucaptcha.com/in.php

Пример формы для текстовой капчи

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

Вы можете испольовать дополнительные параметры в вашем запросе. Полный список параметров приведён в таблице ниже.

Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например:
OK|Пятница
или в формате JSON

если вы использовали параметр json в запросе.

Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

Подождите 5 секунд и отправьте HTTP GET запрос к URL нашего API:
http://rucaptcha.com/res.php с персональным ключом API и полученным ранее идентификатором капчи, чтобы получить результат. Список параметров для запроса приведен в таблице ниже.

Если ваша капча уже решена, сервер вернёт ответ на неё в виде простого текста, например:
OK|TEXT
или в формате JSON

если вы использовали параметр json.

Если ваша капча ещё не решена, сервер вернёт CAPCHA_NOT_READY В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт ошибку, описание которой можно найти в главе Обработка ошибок.

Список параметров POST-запроса к http://rucaptcha.com/in.php

POST параметр Тип Обязателен Описание

key Строка Да your API key

language Число
По умолчанию: 0 Нет 0 — не определено
1 — капча содержит только кириллицу
2 — капча содержит только латиницу

lang Строка Нет Код языка. См. список поддерживаемых языков.

textcaptcha Строка
Максимум 140 символов
Кодировка: UTF-8 Нет Текст капчи.
Например: Если завтра суббота, то какой сегодня день?

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример запроса:

reCAPTCHA V2, также известная как «Я не робот» reCAPTCHA, очень популяна и выглядит вот так:

Решить reCAPTCHA V2 с помощью нашего нового метода очень легко, это не требует эмуляции браузера:

Посмотрите исходный код элемента на странице, где вы встретили reCAPTCHA.

Найдите ссылку, которая начинается с www.google.com/recaptcha/api2/anchor или найдите параметр data-sitekey.

Скопируйте значение параметра k из ссылки или значение data-sitekey.

Отправьте запрос HTTP GET или POST к нашему API:
http://rucaptcha.com/in.php
с персональным ключом API и параметром method, соответствующим виду вашей капчи, в данном случае — userrecaptcha, а также укажите значение, которые вы скопировали ранее в параметре googlekey. Укажите полный URL страницы, на которой вы хотите решить reCAPTCHA в параметре pageurl.
Отправка данных прокси на текущий момент не обязательна, но мы всё же рекомендуем это делать.
Полный список параметров для запроса можно найти в таблице ниже.

Пример URL запроса:

Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например: OK|2122988149 или в формате JSON если вы использовали параметр json в запросе.

Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

Подождите 15-20 секунд и отправьте HTTP GET запрос к нашему API: http://rucaptcha.com/res.php чтобы получить результат.
Полный лист параметров для запроса можно найти в таблице ниже.

Если ваша капча уже решена, то сервер вернёт ответ в виде простого текста или JSON. Ответ представляет собой токен, примерно такой:

Если ваша капча ещё не решена, то сервер вернёт код CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Найдите элемент с id g-recaptcha-response и сделайте его видимым, удалив параметр display:none.

Внимание: иногда содержимое страницы генерируется динамически и вы можете не найти данный элемент.
В таком случае вам нужно изучить скрипты, отвечающие за генерацию содержимого страницы. Опция «Inspect» в Google Chrome может помочь в этом.

На странице отобразится текстовое поле. Всё что вам остается сделать — вставить полученный токен в это поле и отправить форму.

Поздравляем, вы решили reCAPTCHA!

Иногда вы не найдете кнопки, отправляющей форму. Вместо нее может использоваться callback-функция. Эта функция выполняется, когда задание рекапчи выполнено.

Обычно callback-функция определена в параметре data-callback , например:

Или иногда она указана как параметр callback у функции grecaptcha.render , например так:

Кроме того, есть ещё один простой способ найти callback-функцию — это открыть javascript-консоль вашего браузера и изучить объект конфигурации reCAPTCHA:

Имейте в виду, что часть aa.l меняется, а также, что на одном сайте может быть несколько имплементации reCAPTCHA, поэтому вам нужно посмотреть и на clients[1], clients[2] и т.д.

В конце концов вам нужно запустить callback-функцию:

Иногда функция требует какой-либо агрумент на входе. В большинстве случаев нужно передать токен. Например:

У reCAPTCHA V2 также есть невидимая версия.
Её образец можно увидеть по ссылке: https://www.google.com/recaptcha/api2/demo?invisible=true
Кроме того, недавно мы обнаружили некоторые изменения в алгоритме невидимой reCAPTCHA на нескольких сайтах. Мы добавили в API новый параметр invisible=1 который нужно использовать для невидимой reCAPTCHA.
Ниже мы расскажем больше о невидимой reCAPTCHA.

Невидимая рекапча размещена на слое DIV, который имеет z-index — 10 000 px, что делает его невидимым пользователю.

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

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

Если вы всё ещё не уверены, какая reCAPTCHA на сайте — обычная или невидимая — вот несколько способов это определить:

Вы не видите чекбокс «Я не робот», но получаете капчу, когда делаете какое-либо действие на сайте

Ссылка iframe рекапчи содержит параметр size=invisible

Конфигурационный объект рекапчи содержит параметр size, значение которого invisible, например ___grecaptcha_cfg.clients[0].aa.l.size имеет значение invisible

Что делать, чтобы в браузере можно было пройти Invisible reCAPTCHA?

Метод 1: используем javascript:

Измените значение элемента g-recaptcha-response на токен, полученный от нашего сервера:

Выполните действие, которое должно выполняться на сайте после того, как вы решили reCAPTCHA.

Чаще всего на сайте нужно отправить форму. От вас потребуется идентифицировать эту форму по id, имени или какому-то ещё атррибуту и отправить форму. Вот несколько примеров:

А иногда после решения reCAPTCHA вызывается коллбек-функция.

Эта функция определяется в параметре data-callback , например: data-callback=»myCallbackFunction»

И все что вам нужно сделать — вызвать эту функцию:

Ура! Вы сделали это всего двумя строчками кода.

Метод 2: изменяем содержимое страницы:

Вырежьте из тела документа div, содержащий саму рекапчу.

Вырежьте полностью блок:

На место вырезанного блока поставьте следующий код: В котором %g-recaptcha-response% — токен, который вы получили от нашего сервера.

У вас появится кнопка “Submit query”, при нажатии на неё вы отправите на сайт, где установлена капча, все данные формы и g-recaptcha-response.

Список параметров для GET/POST запросов к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да userrecaptcha — определяет, что вы решаете reCAPTCHA V2 с помощью нового метода

googlekey Строка Да Значение параметра k или data-sitekey, которое вы нашли в коде страницы

pageurl Строка Да Полный URL страницы, на которой вы решаете reCAPTCHA V2

domain Строка
По умолчанию: google.com Нет Домен, с которого загружается reCAPTCHA: recaptcha.net или google.com

invisible Число
По умолчанию: 0 Нет 1 — говорит нам, что на сайте невидимая reCAPTCHA. 0 — обычная reCAPTCHA.

data-s Строка Нет Значение параметра data-s найденное на странице. Актуально для поиска в Google и других сервисов Google.

cookies Строка Нет Ваши cookies которые будут использованы работником для решения капчи. В ответе на капчу мы вернем cookies работника, но только при использовании json=1 .
Формат: КЛЮЧ:Значение, разделитель — точка с запятой, например: KEY1:Value1;KEY2:Value2;

userAgent Строка Нет Подставляем у работника ваш userAgent

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

proxy Строка Нет Формат: логин:пароль@123.123.123.123:3128
Больше информации о прокси здесь.

proxytype Строка Нет Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

reCAPTCHA V3 — это новейший вид капчи от Google, который основан на рейтинге «человечности» пользователя и не требует от пользователя выполнения каких-либо заданий.

Во многом новый вид капчи похож на reCAPTCHA V2, т.е. основной принцип остался тем же — пользователь получает от API reCAPTCHA токен, который отправляется в POST-запросе к сайту, а сайт верифицирует токен через API reCAPTCHA.

НО при верификации токена API reCAPTCHA теперь возвращает рейтинг «человечности» пользователя — score — число от 0.1 до 0.9. Получив это значение, сайт решает, как обрабатывать запрос.

Кроме того, появился новый параметр action, который позволяет по разному обрабатывать различные действия пользователя на сайте. При верификации токена API reCAPTCHA вернет имя действия, которое выполнил пользователь.

Наш подход к решению reCAPTCHA V3
Мы провели серию экспериментов и выяснили, что если пользователь на каком-либо сайте получает рейтинг 0.1, то с довольно высокой вероятностью он получит такой же рейтинг и на остальных сайтах.

Мы определяем рейтинг каждого работника нашего сервиса. Затем, когда получаем запрос на решение reCAPTCHA V3 с указанием минимального рейтинга min_score мы отдаем капчу работнику, имеющему рейтинг не ниже запрошенного. Абсолютное большинство решений в результате имеют требуемый рейтинг на том сайте, где нужно решить reCAPTCHA V3.

Как решать reCAPTCHA V3 с помощью нашего сервиса:

В первую очередь нужно убедиться, что на сайте действительно используется reCAPTCHA V3.

Основные признаки V3:

не видна пользователю, не требует кликать по картинкам;

скрипт api.js загружается с параметром render=sitekey, например:
https://www.google.com/recaptcha/api.js?render=6LfZil0UAAAAAAdm1Dpzsw9q0F11-bmervx9g5fE

в массиве clients конфигурационного объекта ___grecaptcha_cfg используется индекс 100000: ___grecaptcha_cfg.clients[100000]

Для решения V3 через наш API необходимо найти значения трех параметров:

sitekey — его можно найти в html в значении параметра render при загрузке api.js, в параметре k в URI iframe, в который подгружается reCAPTCHA, либо в javscript, в вызове функции grecaptcha.execute или в конфигурационном объекте ___grecaptcha_cfg.

action — это значение нужно искать в javascript коде сайта в вызове функции grecaptcha.execute. Пример: grecaptcha.execute(‘6LfZil0UAAAAAAdm1Dpzsw9q0F11-bmervx9g5fE’, ).
Иногда найти его достаточно сложно и требуется перевернуть вверх дном все js-файлы, подгружаемые сайтом. Кроме того, можно попробовать найти значение action в конфигурационном объекте ___grecaptcha_cfg, но очень часто оно может быть не задано там, а передаваться только при вызове grecaptcha.execute — поэтому наиболее эффективный метод — просмотр javascript кода.

pageurl — полный URL страницы, где вы хотите решить reCAPTCHA V3.

Кроме того, нужно понять, какое значение score вам требуется. Определить извне, при каком score сайт решит, что вы человек и пропустит ваш запрос, можно только экспериментально. Самый низкий рейгинг 0.1 — робот, а самый высокий 0.9 — человек. Но, многие сайты ставят пороговые значения от 0.2 до 0.5, т.к. обычный человек зачастую получает довольно низкий рейтинг. С наибольшей вероятностью от нашего API можно получить score 0.3, более высокие значения score у работников встречаются довольно редко.

Имея все необходимые параметры, можно отправлять запрос к нашему API.

Отправьте запрос HTTP GET или POST к нашему API:
http://rucaptcha.com/in.php
с персональным ключом API и параметром method, соответствующим виду капчи, в данном случае — userrecaptcha, в параметре version нужно указать v3, в параметре min_score — требуемое значение score. Также укажите значения, найденные на предыдущем шаге: sitekey укажите в параметре googlekey, полный URL страницы, на которой вы хотите решить reCAPTCHA в параметре pageurl, значение action — в одноименном параметре action, если его не указать мы будем использовать значение по умолчанию — verify.

Пример URL запроса:

Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например: OK|2122988149 или в формате JSON если вы использовали параметр json в запросе.

Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

Подождите 10-15 секунд и отправьте HTTP GET запрос к нашему API: http://rucaptcha.com/res.php с чтобы получить результат по ID вашей капчи.
Полный список параметров запроса можно найти в таблице ниже.

Если ваша капча уже решена, то сервер вернёт ответ в виде простого текста или JSON. Ответ представляет собой токен, примерно такой:

Если ваша капча ещё не решена, то сервер вернёт код CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Пример URL запроса:

После получения токена от нашего API, нужно корректно использовать его на сайте. Лучший метод понять, как это сделать — посмотреть на то, какие запросы отправляются на сайт, когда вы работаете с ним как обычный посетитель. Большинство браузеров позволяют легко это сделать в консоли разработчика, нужная вкладка обычно называется «Network».

Токен обычно отправляется в параметрах POST-запроса, это может быть g-recaptcha-response как у reCAPTCHA V2, g-recaptcha-response-100000 или какой-либо другой параметр. Поэтому нужно внимательно просмотреть параметры запроса и найти, как именно передается токен, а затем сформировать аналогичный запрос.

После того, как вы использовали токен на сайте и стало понятно, сработал он или нет — вы можете сообщить нам об этом. В случае, если токен не был принят — мы вернем деньги за капчу на ваш баланс. А в случае, если токен был принят — мы поставим работника, который его получил в приоритет для ваших запросов. Кроме того, это позволяет нам копить и анализировать статистику по этому виду капч для последующей оптимизации алгоритмов ее решения.

Чтобы сообщить о том, сработал токен или нет — отправьте запрос к http://rucaptcha.com/res.php с вашим ключем API в параметре key, id капчи в одноименном параметре id и указав в параметре action, в зависимости от результата: reportgood — токен сработал или reportbad — токен не сработал.

Примеры запросов:

Важное замечание: в интерфейсе на сайте не отображаются жалобы на любые виды капч с токеном, в том числе reCAPTCHA V3. Мы обрабатываем каждый такой запрос, но пока не придумали адекватный интерфейс для подобных жалоб. В будущем постараемся это сделать.

Список параметров для GET/POST запросов к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да userrecaptcha — определяет, что вы решаете reCAPTCHA

version Строка Да v3 — указывает на то, что это reCAPTCHA V3

googlekey Строка Да Значение параметра sitekey, которое вы нашли в коде сайта

pageurl Строка Да Полный URL страницы, на которой вы решаете reCAPTCHA V2

domain Строка
По умолчанию: google.com Нет Домен, с которого загружается reCAPTCHA: recaptcha.net или google.com

action Строка
По умолчанию: verify Нет Значение параметра action, которые вы нашли в коде сайта

min_score Число
По умолчанию: 0.4 Нет Требуемое значение рейтинга (score). На текущий момент сложно получить токен со score выше 0.3

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу
reportgood — — сообщить о том, что токен сработал
reportbad — — сообщить о том, что токен не сработал

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

reCAPTCHA Enterpise — это новейший вид капчи от Google, который сочетает в себе возможности V2 и V3, а также позволяет администраторам сайта сообщать Google, о том, кто по их мнению взаимодействовал с сайтом после решения капчи — робот или человек.

Как решать reCAPTCHA Enterpise с помощью нашего сервиса:

Найти sitekey и остальные параметры, в зависимости от того, как капча настроена на сайте, у нее может быть action как у V3, а так же min_score.

Отправьте запрос HTTP GET или POST к нашему API:
http://rucaptcha.com/in.php

Пример URL запроса:

Получаете ID вашей капчи.

Запрашиваете ответ у http://rucaptcha.com/res.php

Пример URL запроса:

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

После того, как вы использовали токен на сайте и стало понятно, сработал он или нет — вы можете сообщить нам об этом. В случае, если токен не был принят — мы вернем деньги за капчу на ваш баланс. А в случае, если токен был принят — мы поставим работника, который его получил в приоритет для ваших запросов. Кроме того, это позволяет нам копить и анализировать статистику по этому виду капч для последующей оптимизации алгоритмов ее решения.

Чтобы сообщить о том, сработал токен или нет — отправьте запрос к http://rucaptcha.com/res.php с вашим ключем API в параметре key, id капчи в одноименном параметре id и указав в параметре action, в зависимости от результата: reportgood — токен сработал или reportbad — токен не сработал.

Примеры запросов:

Список параметров для GET/POST запросов к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да userrecaptcha — определяет, что вы решаете reCAPTCHA

version Строка
По умолчанию: v2 Нет Версия reCAPTCHA: v2 или v3

enterprise Число
По умолчанию: 0 Нет 1 — указывает на то, что это reCAPTCHA Enterpise

googlekey Строка Да Значение параметра sitekey, которое вы нашли в коде сайта

pageurl Строка Да Полный URL страницы, на которой вы решаете reCAPTCHA V2

action Строка
По умолчанию: verify Нет Значение параметра action, которые вы нашли в коде сайта

min_score Число
По умолчанию: 0.4 Нет Требуемое значение рейтинга (score). На текущий момент сложно получить токен со score выше 0.3

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

proxy Строка Нет Формат: логин:пароль@123.123.123.123:3128
Больше информации о прокси здесь.

proxytype Строка Нет Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу
reportgood — — сообщить о том, что токен сработал
reportbad — — сообщить о том, что токен не сработал

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Этот метод подходит для решения капч, на которых на изображение наложена сетка: reCAPTCHA, hCaptcha, некоторые виды ArkoseLabs FunCaptcha.

Мы можем решать reCAPTCHA с различными сетками: 3×3, 2×4, 4×4.

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

Чтобы решить капчу вам нужно:

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

Определить размер сетки и указать её размеры в параметрах:
recaptchacols — количество колонок,
recaptcharows — количество строк.
Если размер сетки не определён, мы проверим размер изображения, и в случае, если размер 300х300 пикселей, мы наложим сетку 3×3. Если изображение имеет другой размер, мы наложим на него сетку 4×4.

Отправить запрос HTTP POST к нашему API:
http://rucaptcha.com/in.php
установив значение параметра recaptcha равным 1.

Сервер принимает изображения в формате multipart или base64. Вам неоходимо отправлять только набор изображений без сетки и синего блока.

Также необходимо передать инструкцию, какие изображения нужно выбрать. Это можно сделать с помощью параметра textinstructions или imginstructions. Полный список параметров предоставлен в таблице ниже.

Сервер вернёт ID вашей капчи или код ошибки, если что-то пошло не так.

Подождите 5 секунд и отправьте запрос HTTP GET к нашему API:
http://rucaptcha.com/res.php
чтобы получить результат.

Если ваша капча решена, то сервер вернёт ответ с номерами клеток сетки, на которые нужно кликать, например: OK|click:3/8/9.

Нумерация клеток идет от 1 слева направо и сверху вниз.

Если капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. Повторите ваш запрос через 5 секунд.

Если возникла проблема с обработкой вашей капчи, сервер вернёт код ошибки.

Вы кликаете на клетки, номера которых получили в ответе.

В случае, если reCAPTCHA обновляет набор картинок для того же задания, вы можете отправить новый запрос включающий дополнительный параметр previousID указав в нем ID предыдущего запроса. Тогда наш работник будет проверять только обновленные изображения с учетом предыдущего ответа.

Кроме того, вы можете отправлять еще один дополнительный параметр can_no_answer в случае, если в наборе изображений не остается подходящих и мы покажем работнику кнопку «нет подходящих изображений», а API вернет овтет No_matching_images.

Метод canvas

В случае, если задание reCAPTCHA требует обвести объект вы можете передать параметр canvas со значением 1.

Сервер вернёт ответ в формате: canvas:x,y,x,y,x,y;x,y,x,y,x,y;

Где каждая пара x и y — это координаты точек, на которые нужно поочередно кликать, чтобы обвести зону, в которой находится объект. Если таких зон несколько, то их координаты будут разделены точкой с запятой.

Точка 0,0 — это левый верхний угол изображения.

Чтобы пройти задание, вам нужно поочередно кликать на полученные точки.

Пример формы для reCAPTCHA V2 (устаревший метод) в формате multipart

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

Пример формы для отправки reCAPTCHA V2 (устаревший метод) в формате base64

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

BASE64_RECAPTCHA_FILE — закодированное в формате base64 тело изображения reCAPTCHA V2.

BASE64_INSTRUCTION_FILE — закодированное в формате base64 тело изображения с инструкцией.

Список параметров POST-запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да post — говорит о том, что вы отправляете изображение с помощью multipart-фомы
base64 — говорит о том, что вы отправляете изображение в формате base64

recaptcha Число Да 1 — говорит о том, что вы отправляете reCAPTCHA в виде изображения

canvas Число
По умолчанию: 0 Нет 1 — говорит о том, что вы хотите использовать метод canvas

file Файл Да* Файл изображения.
* — обязателен, если вы отправляете картинку как файл (method=post)

body Строка Да* Изображение, закодированное в формат Base64,
* — обязателен, если вы отправляете картинку в Base64 (method=base64)

textinstructions Строка
Максимум 140 символов
Кодировка: UTF-8 Да Текст с инструкцией, какие изображения выбирать.
Например: выберите все изображения с деревьями.
Не обязателен если вы отправляете инструкцию в виде изображения с помощью параметраimginstructions.

imginstructions Изображение
Макс. 450x150px, 100 Кбайт Нет Изображение будет показано работнику, чтобы помочь ему решить капчу правильно.
Сервер принимает изображения в формате multipart или base64.

recaptcharows Число Нет Количество строк в сетке.

recaptchacols Число Нет Количество колонок в сетке.

previousID Строка Нет Id вашего предыдущего запроса в рамках того же задания reCAPTCHA

can_no_answer Число
По умолчанию: 0 Нет 0 — не определено
1 — возможно, что изображение не содержит картинок, которые удовлетворяют инструкции.
Устанавливайте значение 1 только если на изображении может не быть картинок с правильным ответом.
Мы покажем работнику кнопку «Нет подходящих картинок», а вы получите в ответе No_matching_images.

language Число
По умолчанию: 0 Нет 0 — не определено
1 — капча содержит только кириллицу
2 — капча содержит только латиницу

lang Строка Нет Код языка. См. список поддерживаемых языков.

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Внимание: вам необходимо отправлять само изображение, а не скриншот. Не пытайтесь комбинировать изображение с чем-либо ещё, отправляйте его как есть.
Максимальный размер изображения для reCAPTCHA 100 Кбайт.
Максимальный размер изображения для imginstructions 100 Кбайт.

Список параметров для GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример запроса:

reCAPTCHA V1 устарела и была заменена на reCAPTCHA V2, но всё ещё встречается на некоторых сайтах.

Она может иметь различные темы оформления и выглядит примерно так:

Для решения reCAPTCHA V1 вам требуется:

Загрузить страницу по ссылке src из элемента noscript и найти элемент с id recaptcha_challenge_field в исходном коде страницы.

Получить изображение по ссылке: www.google.com/recaptcha/api/image?c=recaptcha_challenge_field .

Отправить изображение на наш сервер с помощью HTTP POST-запроса так же, как в случае с обычной капчей.

Последующие шаги алгоритма решения капчи не отличается от решения обычной капчи.

Этот метод позволяет решать любую капчу, которая требует кликать по изображениям, например Ghost Captcha в SnapChat, reCAPTCHA V2, ASIRRA и т.п.

Чтобы решить капчу нужно:

Получить изображение и инструкцию, по каким картинкам кликать.

Отправить запрос HTTP POST к нашему API: http://rucaptcha.com/in.php указав 1 в качестве значениея параметра coordinatescaptcha.
Сервер принимает изображения в формате multipart или base64.

Вы можете передать дополнительные инструкции в виде текста с помощью параметра textinstructions, но это необязательно, если инструкция уже содержится на изображении.

Полный список параметров приведён в таблице ниже.

Сервер вернёт ID капчи или код ошибки, если что-то пошло не так.

Подождите 5 секунд и отправьте HTTP GET запрос к нашему API: http://rucaptcha.com/res.php чтобы получить результат.

Если ваша капча уже решена, сервер вернёт координаты точек, по которым нужно кликнуть, например: OK|coordinate:x=39,y=59;x=252,y=72. Точка с координатами x=0,y=0 — верхний левый угол изображения.

Если ваша капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Чтобы пройти задание, вам нужно поочередно кликать по полученным координатам.

Пример multipart-формы для Coordinates

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

Пример формы для загрузки ClickCaptcha в формате base64

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

BASE64_CLICKCAPTCHA_FILE — тело файла изображения, закодированное в формате base64.

Список параметров POST-запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да post — говорит о том, что вы отправляете изображение с помощью multipart-фомы
base64 — говорит о том, что вы отправляете изображение в формате base64

coordinatescaptcha Число Да 1 — указывает, что вы отправляете ClickCaptcha

file Файл Да* Файл изображения.
* — обязателен, если вы отправляете картинку как файл (method=post)

body Строка Да* Изображение, закодированное в формат Base64,
* — обязателен, если вы отправляете картинку в Base64 (method=base64)

textinstructions Строка
Максимум 140 символов
Кодировка: UTF-8 Да Текст с инструкцией по решению ClickCaptcha.
Например: выберите всех привидений
Необязателен, если инструкция уже есть на изображении.

imginstructions Изображение
Макс. 450x150px, 100 Кбайт Нет Изображение будет показано работнику, чтобы помочь ему решить капчу правильно.
Сервер принимает изображения в формате multipart или base64.

language Число
По умолчанию: 0 Нет 0 — не определено
1 — капча содержит только кириллицу
2 — капча содержит только латиницу

lang Строка Нет Код языка. См. список поддерживаемых языков.

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров для GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример запроса:

RotateCaptcha — это вид капчи, для решения которой нужно поворачивать изображение. Наиболее популярная реализация — FunCaptcha.

Для решения RotateCaptcha требуется:

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

Не обязательно: определить угол поворота в градусах для одного шага и передать его в параметре angle.
Если не указан — мы используем значение по умолчанию для FunCaptcha: 40 градусов.

Полный список параметров приведен в таблице ниже.

Отправить изображения на наш сервер с помощью запроса HTTP POST к нашему API: http://rucaptcha.com/in.php указав значение rotatecaptcha для параметра method. Сервер принимает изображения в формате multipart или base64.

Сервер вернёт ID вашей капчи или код ошибки.

Подождите 5 секунд и отправьте запрос HTTP GET к нашему API: http://rucaptcha.com/res.php чтобы получить результат.

Если ваша капча решена, сервер вернёт ответ, содержащий углы поворота для каждого изображения, например: OK|40|200|-120.
Положительные значение означают что изображение нужно повернуть по часовой стрелке, отрицательные — против часовой стрелки.

Если ваша капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт ошибку, описание которой можно найти в главе Обработка ошибок.

Для решения вашей RotateCaptcha поверните изображения на соответствующий угол.

Пример multipart-формы для отправки RotateCaptcha файлом

Пример формы для отправки RotateCaptcha в формате base64

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

Список параметров POST-запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да Метод решения капчи.
rotatecaptcha — указывает на то, что вы отправляете RotateCaptcha

angle Число
По умолчанию: 40 Нет Угол поворота за один шаг в градусах.
Если не указано, используется значение по умолчанию для FunCaptcha: 40 градусов.

file Изображение Да* Файл изображения.
* — обязателен, если вы отправляете картинку как файл (method=post)

body Строка Да* Изображение, закодированное в формат Base64.
* — обязателен, если вы отправляете картинку в Base64 (method=base64)

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров для GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример запроса:

Теперь мы предоставляем метод для решения Arkose Labs FunCaptcha с помощью токена.

Этот метод очень прост:

Вам нужно найти публичный ключ FunCaptcha и сервисный URL (surl).
Публичный ключ можно найти в значении параметра data-pkey у div с FunCaptcha или же найти элемент с именем (name) fc-token , а из его значения вырезать ключ, который указан после pk .

Сервисный URL можно найти в том же элементе с именем fc-token — это значение после surl . Этот параметр не обязателен и если вы его не указали — мы используе значение по умолчанию, которое работает в большинстве случаев. Но все же мы рекомендуем его указывать на случай, если на сайте используется нестандартный вариант.

Отправьте HTTP GET или POST запрос к нашему API: http://rucaptcha.com/in.php , указав значение параметра method равным funcaptcha, найденный ранее публичный ключ укажите в параметре publickey, а surl в одноименном параметре запроса. Полный URL страницы укажите в параметре pageurl.
Полный список параметров для запроса можно найти в таблице ниже.

Пример URL запроса:

Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например: OK|2122988149 или в формате JSON , если вы использовали параметр json в запросе.

Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

Подождите 15-20 секунд и отправьте HTTP GET запрос к нашему API: http://rucaptcha.com/res.php , чтобы получить результат.
Полный список параметров для запроса можно найти в таблице ниже.

Если ваша капча уже решена, сервер вернёт ответ в виде простого текста или JSON. Ответ представляет собой токен, примерно такой:

Если ваша капча ещё не решена, сервер вернёт код CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Найдите элемент с id fc-token и измените его значение (value) на полученый токен.

Осталось лишь сделать то, что вы хотели сделать на сайте: отправить форму, кликнуть на кнопку или что-то ещё.

Список параметров для GET/POST запросов к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да funcaptcha — указывает, что вы решаете FunCaptcha с помощью токена

publickey Строка Да Значение параметра pk или data-pkey которое вы нашли в коде страницы

surl Строка Нет Значение параметра surl которое вы нашли в коде страницы

data[key] Строка Нет Дополнительные данные передаваемые при загрузке FunCaptcha.
Пример: data[blob]=stringValue

pageurl Строка Да Полный URL страницы, на которой вы решаете FunCaptcha

userAgent Строка Нет Говорит нам использовать ваш user-agent.

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

proxy Строка Нет Формат: логин:пароль@123.123.123.123:3128
Больше информации о прокси здесь.

proxytype Строка Нет Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

Аудио капча — это тип капч, для решения которых необходимо прослушать сообщение и ввести текст, который вы слышите.
Наиболее известные виды таких капч — это Audio reCAPTCHA V2 и SolveMedia.

Мы предоставляем возможность автоматического распознавания такого вида капч. Распознавание чери производится роботом.
Мы не предоставляем возможности сообщить о некорректном распозавании таких капч.

Для решения Audio Captcha требуется:

Скачать аудио файл.

Отправить аудио файл в формате MP3 на наш сервер с помощью HTTP POST запроса к нашему API: http://rucaptcha.com/in.php указывая значение параметра:
recaptchavoice равным 1 для Audio reCAPTCHA V2.
solveaudio равным 1 для SolveMedia.
Полный список параметров приведен в таблице ниже.

Сервер принимает аудио файлы отправленные с помощью multipart формы.

Сервер вернёт вам ID вашей капчи или код ошибки в случае, если что-то не так.

Подождите 20-30 секунд (обычно длительность аудио в этих пределах), а затем отправьте HTTP GET запрос к нашему API: http://rucaptcha.com/res.php чтобы получить результат.

Если аудио уже распознано, то сервер вернёт ответ: OK|текст из аудио.

Если распознование ещё не завершено, сервер вернёт CAPCHA_NOT_READY. Повторите ваш запрос через 5 секунд.

В случае возникновения ошибки сервер вернёт код ошибки.

Если Google забанил ваш IP адрес, то он начнет отправлять вам файл, в котором женский голос проговаривает:
«We’re sorry, but your computer or network may be sending automated queries. To protect our users, we can’t process your request right now. For more details visit www.google.com/recaptcha/securityhelp».
Мы не примем такой файл и не возьмем с вас денег за него. Вы получите ошибку: ERROR_YOUR_IP_IS_BANNED_BY_GOOGLE.

Вам всего лишь нужно ввести ответ в поле для ответа.

Пример формы для отправки Audio Captcha

Список параметров POST-запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да Метод отправки формы.
post — указывает на то, что вы отправляете аудио файл с помощью multipart формы.

recaptchavoice Число Да 1 — указывает на то, что вы отправляете Audio reCAPTCHA V2.
Не требуется если вы отправялете SolveMedia.

solveaudio Число Да 1 — указывает на то, что вы отправляете SolveMedia.
Не требуется если вы отправляете Audio reCAPTCHA V2.

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом получают 10% от всех трат пользователей их ПО.

Список параметров для GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример запроса:

KeyCaptcha — это такой вид капчи, для решения которой нужно собрать небольшой пазл.

Чтобы решить KeyCaptcha с помощью нашего сервиса, нужно:

Найти следующие параметры KeyCaptcha в исходном коде страницы:

Отправить HTTP GET или POST запрос к нашему API: http://rucaptcha.com/in.php указав method равным keycaptcha и передать в запросе соответствующие значения параметров, найденные на предыдущем шаге, а также указать в параметре pageurl полный URL страницы с KeyCaptcha.
Полный список параметров приведен в таблице ниже.

Пример запроса:

Если запрос был составлен верно, то сервер вернёт ID капчи в виде простого текста, например: OK|2122988149 или в виде JSON , если вы использовали параметрjson.
В противном случае сервер вернёт код ошибки.

Подождите 15-20 секунд и отправьте запрос HTTP GET к нашему API: http://2captcha.com/res.php чтобы получить результат.
Полный список параметров доступен в таблице ниже.

Если капча уже решена, сервер вернёт ответ в виде простого текста или JSON. Ответ выглядит примерно так:

Если капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Найдите и удалите следующий блок, который подключает javascript-файл:

Найдите и удалите элемент div с :

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

Найдите элемент с и измените его значение на ответ, полученный от нашего сервера.

Нажмите на кнопку, отправляющую форму.

Ура, вы прошли KeyCaptcha!

Весь этот процесс может быть легко автоматизирован. Посмотрите пример javascript кода, который делает это прямо в консоли браузера.

Пример формы multipart для отправки KeyCaptcha

Параметр YOUR_APIKEY нужно заменить на ваш ключ API.

Список параметров GET/POST запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да keycaptcha — говорит о том, что вы отправляете KeyCaptcha

s_s_c_user_id Строка Да Значение параметра s_s_c_user_id, найденное на странице

s_s_c_session_id Строка Да Значение параметра s_s_c_session_id, найденное на странице

s_s_c_web_server_sign Строка Да Значение параметра s_s_c_web_server_sign, найденное на странице

s_s_c_web_server_sign2 Строка Да Значение параметра s_s_c_web_server_sign2, найденное на странице

pageurl Строка Да Полный URL страницы с KeyCaptcha

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

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

Чтобы решить Geetest-капчу через наш API необходимо:

Найти следующие параметры на странице сайта с капчей (обычно их можно найти внутри функции initGeetest):

gt — публичный ключ сайта (статический)

challenge — динамический ключ задания

api_server — домен API (обязателен для некоторых сайтов)

Важно: для каждого запроса к нашему API необходимо получать новое значение challenge. Если капча уже была загружена на странице, то значение challenge является недействительным. Вам необходимо изучить запросы, которые выполняются при загрузке страницы и найти тот, в котором возвращается значение challenge. Затем, для получения нового challenge вам нужно каждый раз выполнять данный запрос и парсить его.

Отправьте запрос HTTP GET или POST к нашему API: http://rucaptcha.com/in.php указав в значении параметра method значение geetest, а также передайте значения, найденные на предыдущем шаге в соответствующих параметрах и полный URL страницы с капчей в pageurl.
Полный список параметров можно найти в таблице ниже.

Пример запроса:

Если запрос был составлен верно, то сервер вернёт ID капчи в виде простого текста, например: OK|2122988149 или в виде JSON , если вы использовали параметрjson.
В противном случае сервер вернёт код ошибки.

Подождите 15-20 секунд и отправьте запрос HTTP GET к нашему API: http://2captcha.com/res.php чтобы получить результат.
Полный список параметров доступен в таблице ниже.

Если капча уже решена, сервер вернёт ответ в формате JSON. Ответ содержит три параметра: challenge , validate и seccode :

Если капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Используйте значения, полученные в ответе от нашего API в запросе к сайту, передавая их в соотстветствующих полях запроса:

geetest_challenge

geetest_validate

geetest_seccode

Список параметров GET/POST запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да geetest — указывает, что вы отправляете капчу Geetest

gt Строка Да Значение параметра gt найденное на сайте

challenge Строка Да Значение параметра challenge найденное на сайте

api_server Строка Нет Значение параметра api_server найденное на сайте

pageurl Строка Да Полный URL страницы с капчей Geetest

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

proxy Строка Нет Формат: логин:пароль@123.123.123.123:3128
Больше информации о прокси здесь.

proxytype Строка Нет Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 1 Нет Для Geetest ответ всегда возвращается в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

Geetest v4 — это новая версия капчи от Geetest, где вам всё еще нужно двигать кусочек пазла, чтобы пройти ее.

Чтобы решить Geetest-капчу через наш API необходимо:

Найти на странице сайта с капчей значение captcha_id — обычно его можно найти внутри тега script , который подключает javascript код Geetest v4 на странице.

Отправьте запрос HTTP GET или POST к нашему API: http://rucaptcha.com/in.php указав method=geetest_v4 , значение captcha_id , найденное на странице а также полный URL страницы с капчей в pageurl .

Пример запроса:

Если запрос был составлен верно, то сервер вернёт ID капчи в виде простого текста, например: OK|2122988149 или в виде JSON , если вы использовали параметрjson.
В противном случае сервер вернёт код ошибки.

Подождите 15-20 секунд и отправьте запрос HTTP GET к нашему API: http://rucaptcha.com/res.php чтобы получить результат.

Если капча уже решена, сервер вернёт ответ в формате JSON. Пример ответа:

Если капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Используйте значения, полученные в ответе от нашего API в запросе к сайту, передавая их аналогично тому, как они передаются, если вы решаете капчу вручную.

Список параметров GET/POST запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да geetest_v4 — указывает, что вы отправляете капчу Geetest v4

pageurl Строка Да Полный URL страницы с капчей Geetest

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

proxy Строка Нет Формат: логин:пароль@123.123.123.123:3128
Больше информации о прокси здесь.

proxytype Строка Нет Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 1 Нет Для Geetest ответ всегда возвращается в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

hCaptcha — это относительно новый вид капчи, который очень похож на reCAPTCHA

Принцип решения капчи довольно прост:

Найдите в исходном коде страницы значение параметра data-sitekey.

Отправьте запрос HTTP GET или POST к нашему API:
http://rucaptcha.com/in.php
с персональным ключом API и параметром method, соответствующим виду вашей капчи, в данном случае — hcaptcha, а также укажите значение, которые вы скопировали ранее в параметре sitekey. Укажите полный URL страницы, на которой вы хотите решить hCaptcha в параметре pageurl.
Полный список параметров для запроса можно найти в таблице ниже.

Пример URL запроса:

Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например: OK|2122988149 или в формате JSON если вы использовали параметр json в запросе.

Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

Подождите 15-20 секунд и отправьте HTTP GET запрос к нашему API: http://rucaptcha.com/res.php чтобы получить результат.
Полный список параметров для запроса можно найти в таблице ниже.

Если ваша капча уже решена, то сервер вернёт ответ в виде простого текста или JSON. Ответ представляет собой токен, примерно такой:

Если ваша капча ещё не решена, то сервер вернёт код CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Поместите полученный токен в скрытые элементы h-captcha-response и g-recaptcha-response и отправьте форму.

Список параметров для GET/POST запросов к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да hcaptcha — указывает, что вы решаете hCaptcha

sitekey Строка Да Значение параметра data-sitekey, которое вы нашли в коде страницы

pageurl Строка Да Полный URL страницы, на которой вы решаете hCaptcha

invisible Число
По умолчанию: 0 Нет Используйте значение 1 для невидимой версии hcaptcha (в настоящее время встречается крайне редко)

domain Строка
По умолчанию: hcaptch.com Нет Домен, с которого загружается hCaptcha: hcaptcha.com или js.hcaptcha.com

data Строка Нет Дополнительные данные для решения капчи — используется в очень редких случаях и только в сочетании с invisible=1 .
В большинстве случаев встречается в виде параметра rqdata в сетевых запросах.
ВАЖНО: вы ДОЛЖНЫ указать userAgent если присылаете data . Значение userAgent должно соответствовать User-Agent который вы используете при взаимодействии с сайтом, на котором решаете капчу.

userAgent Строка Нет Подставляем у работника ваш userAgent

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

proxy Строка Нет Формат: логин:пароль@123.123.123.123:3128
Больше информации о прокси здесь.

proxytype Строка Нет Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

Yandex Smart Captcha — это обновленная капча от Яндекса. Она представляет собой сочетание невидимой капчи, подобной reCAPTCHA V3 с обычной капчей.

Сначала вы кликаете на чекбокс Я не робот и капча проверяет Fingerprint вашего браузера. Затем, если капча решает, что ваш браузер похож на бота, выдается дополнительное задание в виде обычной капчи — картинка с искаженным текстом.

После ввода ответа генерируется токен, который верифицируется через API Yandex Smart Captcha запросом, который отправляется через бекенд сайта.

Капча предоставляет гибкие возможности использования ее на сайтах: есть callback , а также методы smartCaptcha.render , smartCaptcha.execute , smartCaptcha.reset и smartCaptcha.getResponse хорошо знакомые по JavaScript API reCAPTCHA и позволяющие владельцам сайтов быстро мигрировать на новую капчу.

Для решения Yandex Smart Captcha:

Найдите значение sitekey в исходном коде страницы или подключенных JavaScript скриптах. Параметр sitekey можно найти в URL iframe капчи или в параметрах вызова smartCaptcha.render .

Отправьте запрос HTTP GET или POST к нашему API:
http://rucaptcha.com/in.php
с персональным ключом API и параметром method, соответствующим виду вашей капчи, в данном случае — yandex, а также укажите значение sitekey, который вы нашли на странице и полный URL страницы, на которой вы хотите решить капчу в параметре pageurl.
Полный список параметров для запроса можно найти в таблице ниже.

Пример URL запроса:

Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например: OK|2122988149 или в формате JSON если вы использовали параметр json в запросе.

Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

Подождите 15-20 секунд и отправьте HTTP GET запрос к нашему API: http://rucaptcha.com/res.php чтобы получить результат.
Полный список параметров для запроса можно найти в таблице ниже.

Если ваша капча уже решена, то сервер вернёт ответ в виде простого текста или JSON. Ответ представляет собой токен, примерно такой:

Если ваша капча ещё не решена, то сервер вернёт код CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

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

По умолчанию токен помещается в скрытый элемент input с аттрибутом name smart-token и может быть отправлен вместе с данными формы, внутри которой он находится этот элемент.

Также сайт может использовать коллбек или получать токен из вызова метода smartCaptcha.getResponse

В любом случае вы можете подставить токен в соответствующий запрос к бекенду сайта.

Список параметров для GET/POST запросов к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да yandex — указывает, что вы решаете Yandex Smart Captcha

sitekey Строка Да Значение параметра sitekey, которое вы нашли в коде страницы

pageurl Строка Да Полный URL страницы, на которой вы решаете Yandex Smart Captcha

userAgent Строка Нет Подставляем у работника ваш userAgent

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

proxy Строка Нет Формат: логин:пароль@123.123.123.123:3128
Больше информации о прокси здесь.

proxytype Строка Нет Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

Capy — это капча в виде пазла

Принцип решения капчи предельно прост:

Найдите в исходном коде страницы ключ капчи. Его можно найти в поле с именем (аттрибут name) capy_captchakey, либо в ссылке на скрипт https://www.capy.me/puzzle/get_js/?k=PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v .

Также, возьмите часть URL скрипта, указывающую на root-директорию сервера, например https://www.capy.me/ и передайте ее в параметре api_server

Отправьте запрос HTTP GET или POST к нашему API:
http://rucaptcha.com/in.php
с персональным ключом API и параметром method, соответствующим виду вашей капчи, в данном случае — capy, а также укажите найденный ключ капчи в параметре captchakey. Укажите полный URL страницы, на которой вы хотите решить Capy в параметре pageurl.
Полный список параметров для запроса можно найти в таблице ниже.

Пример URL запроса:

Если вы отправили корректный запрос, сервер вернёт ID вашей капчи в виде простого текста, например: OK|2122988149 или в формате JSON если вы использовали параметр json в запросе.

Если что-то пошло не так, сервер вернёт ошибку. Описание ошибок приведено в главе Обработка ошибок.

Подождите 15-20 секунд и отправьте HTTP GET запрос к нашему API: http://rucaptcha.com/res.php чтобы получить результат.
Полный список параметров для запроса можно найти в таблице ниже.

Если капча уже решена, сервер вернёт ответ в формате JSON. Ответ содержит три параметра: captchakey , challengekey и answer :

Если капча ещё не решена, сервер вернёт CAPCHA_NOT_READY. В таком случае повторите ваш запрос через 5 секунд.

Если что-то пошло не так, сервер вернёт код ошибки.

Используйте значения, полученные в ответе от нашего API в запросе к сайту, передавая их в соотстветствующих полях запроса:

capy_captchakey

capy_challengekey

capy_answer

Список параметров для GET/POST запросов к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да capy — указывает, что вы решаете Capy Puzzle

captchakey Строка Да Значение параметра captchakey, которое вы нашли в коде страницы

pageurl Строка Да Полный URL страницы, на которой вы решаете hCaptcha

api_server Строка Нет URL сервера, с которого подгружается капча. По умолчанию: https://jp.api.capy.me/

version Строка
По умолчанию: puzzle Нет Вид задания: puzzle (собрать пазл) или avatar (перетянуть предмет)

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров GET-запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 1 Нет Для Capy Puzzle сервер всегда вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

Данный метод временно не поддерживается.

res.php , но в этом случае есть риск превышения лимитов и блокировки доступа к API, если вы будете решать параллельно большое количество таких капч.

Для обхода капчи TikTok:

Используйте следующие значения параметров aid и host :
https://www.tiktok.com/login/phone-or-email/emailhttps://ads.tiktok.com/i18n/signup/

Очистите cookies и откройте страницу, на которой требуется обойти капчу. НЕ ВЫПОЛНЯЙТЕ действие, которое приводит к вызову капчи.

Получите все cookies, установленные сайтом.

Используйте все требуемые параметры: cookies , aid , host , pageurl в запросе к нашему API.
При работе по HTTP (in.php, res.php) cookies передаются в в виде строки, где имя и значение разеляются двоеточием, а cookies между собой — точкой с запятой, вот так: имя:значение;другая_кука:ее_значение;еще_одна:другое_значение . Домен и прочие параметры передавать не нужно.

Получите ответ от API. В нем будет содержаться набор cookies, которые нужно применить в вашем браузере или http-запросе. Домен для cookies используется тот же, что и был в оригинальном наборе, который вы получили от сайта.
После применения cookies выполните требуемое действие, защищенное капчей (например, нажатие кнопки входа или регистрации). Если между решением капчи на нашей стороне и действием прошло менее трех секунд — капча отображена не будет.

Пример ответа от API в виде JSON:

Пример ответа от API в виде текста:

Параметры запроса для решения капчи

Параметр Тип Обязателен Описание

key Строка Да ваш ключ API

method Строка Да tiktok — указывает, что вы решаете капчу TikTok

cookies Строка Да Ваши cookies которые будут переданы работнику для решения капчи.
Формат: ИМЯ:Значение, разделитель: точка с запятой, пример: KEY1:Value1;KEY2:Value2;

aid Число Да Значение aid для страницы с капчей

host Строка Да Значение host для страницы с капчей

pageurl Строка Да Полный URL страницы, на которой вы решаете hCaptcha

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

proxy Строка Нет Формат: логин:пароль@123.123.123.123:3128
Больше информации о прокси здесь.

proxytype Строка Нет Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Список параметров GET-запроса к http://rucaptcha.com/res.php

Не рекомендуется запрашивать ответ для TikTok у res.php . Вместо этого рекомендуем использовать WebSocket API или Pingback.

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 1 Нет Рекомендуется всегда использовать для TikTok

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Пример URL запроса:

Lemin — один из видов капчи, использующей пазлы

Для регения капчи нужно:

Найти значение captcha_id в исходном коде страницы или в ссылке на скрипт капчи, которая выглядит следующим образом: https://api.leminnow.com/captcha/v1/cropped/CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d901d/js.

Также, нужно взять основную часть URL вида: https://api.leminnow.com/ — это будет значением параметра api_server .

И, наконец, нужно определить id родительского div элемента капчи — это значение нужно будет передать в параметре div_id .

Оправьте запрос HTTP GET or POST к нашему API: http://rucaptcha.com/in.php устанавив значение параметра method в lemin, а также передайте значение параметров captcha_id, div_id и api_server и полный URL страницы с капчей в параметре pageurl.
Описание всех параметров доступно в таблице ниже.

Пример запроса:

API вернет вам ID капчи: Текстом OK|2122988149 или в JSON . Если запрос был некорректным — вы получит код ошибки.

Подождите 10-15 секунд и запрашивайте ответHTTP GET у API: http://rucaptcha.com/res.php .
Полный список параметров в таблице ниже.

Если капча решена, вы получите в ответе значения answer и challenge_id

Если капча не решена — получитеCAPCHA_NOT_READY. Повторите запрос через 5 секунд.

Если возникла ошибка, API вернет соотвествующий код ошибки.

Используйте полученные значения для запроса к сайту, где обходите капчу:

answer

challenge_id

Список параметров GET/POST запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да вш ключ API

method Строка Да lemin — указывает что вы решаете капчу Lemin

captcha_id Строка Да Значение параметра captcha_id найденное на странице

div_id Строка Да id родительского div, внутри которого находится капча

api_server Строка Нет Основная часть URL, откуда подгружаются скрипты капчи. По умолчанию: https://api.leminnow.com/

pageurl Строка Да Полный URL страницы с капчей

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров GET запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 1 Нет Для Lemin сервер всегда вернёт ответ в формате JSON

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Request URL example:

Cloudflare Turnstile — капча от Cloudflare

Для решения капчи нужно:

Найти значение sitekey в исходном коде страницы или JS-коде сайта. В API капчи это значение передается либо в аттрибуте data-sitekey у div-элемента капчи, либо в свойстве sitekey в JavaScript коде. Также, его можно найти в URL iframe капчи. Формат значения: 0x1AAAAAAAAkg0s2VIOD34y5.

Кроме того капча может иметь еще два дополнительных строковых параметра: action (аттрибут data-action) и data (аттрибут data-cdata).

Оправьте запрос HTTP GET or POST к нашему API: http://rucaptcha.com/in.php устанавив значение параметра method в turnstile, а также передайте sitekey и полный URL страницы с капчей в параметре pageurl.
Описание всех параметров доступно в таблице ниже.

Пример запроса:

API вернет вам ID капчи: Текстом OK|2122988149 или в JSON . Если запрос был некорректным — вы получит код ошибки.

Подождите 10-15 секунд и запрашивайте ответHTTP GET у API: http://rucaptcha.com/res.php .
Полный список параметров в таблице ниже.

Если капча решена, вы получите в ответе токен следующего вида:

Если капча не решена — получитеCAPCHA_NOT_READY. Повторите запрос через 5 секунд.

Если возникла ошибка, API вернет соотвествующий код ошибки.

Используйте полученный токен при работе с сайтом, где обходите капчу. Токен чаще всего передается через элекмент input с аттрибутом name=»cf-turnstile-response» , а если используется режим совместимости с reCAPTCHA, то еще и через input с аттрибутом name=»g-recaptcha-response» . Или же через коллбек-функцию, которая задается при вызове turnstile.render в свойстве callback или через аттрибут data-callback .

Список параметров GET/POST запроса к http://rucaptcha.com/in.php

Параметр Тип Обязателен Описание

key Строка Да вш ключ API

method Строка Да turnstile — указывает что вы решаете капчу turnstile

sitekey Строка Да Значение параметра sitekey найденное на странице

action Строка Нет Значение дополнительного параметра action, найденного на странице.

data Строка Нет Значение дополнительного параметра data, найденного на странице.

pageurl Строка Да Полный URL страницы с капчей

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

pingback Строка Нет URL для автоматической отправки ответа на капчу (callback).
URL должен быть зарегистрирован на сервере. Больше информации здесь.

json Число
По умолчанию: 0 Нет 0 — сервер вернёт ответ в виде простого текста
1 — сервер вернёт ответ в формате JSON

soft_id Число Нет ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

Список параметров GET запроса к http://rucaptcha.com/res.php

GET параметр Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу

id Число Да ID капчи, полученный от in.php.

json Число
По умолчанию: 1 Нет 1 — вернуть ответ в JSON, 0 — в виде текста

header_acao Число
По умолчанию: 0 Нет 0 — выключен
1 — включен
Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ.
Используется для кроссдоменных AJAX-запросов из веб-приложений.

Request URL example:

Наш API позволяет указать язык капчи с помощью параметра lang .

Каждый работник нашего сервиса может рассказать нам, какими языками он владеет. Когда вы отправляете нам капчу с указанием языка в параметре lang мы распределяем вашу капчу работникам, которые говорят на этом языке. Это позволяет решать капчи на разных языках, например китайском или вьетнамском.

Список поддерживаемых языков приведен в таблице.

Код языка (значение lang ) Язык

en Английский

ru Русский

es Испанский

pt Португальский

uk Украинский

vi Вьетнамский

fr Французский

id Индонезийский

ar Арабский

ja Японский

tr Турецкий

de Немецкий

zh Китайский

fil Филиппинский

pl Польский

th Тайский

it Итальянский

nl Нидерландский

sk Словацкий

bg Болгарский

ro Румынский

hu Венгерский

ko Корейский

cs Чешский

az Азербайджанский

fa Персидский (Фарси)

bn Бенгальский

el Греческий

lt Литовский

lv Латышский

sv Шведский

sr Сербский

hr Хорватский

he Иврит

hi Хинди

nb Норвежский

sl Словенский

da Датский

uz Узбекский

fi Финский

ca Каталонский

ka Грузинский

ms Малайский

te Телугу

et Эстонский

ml Малаялам

be Белорусский

kk Казахский

mr Маратхи

ne Непальский

my Бирманский

bs Боснийский

hy Армянский

mk Македонский

pa Панджаби

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

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

Обычно, если при обработке вашего запроса возникла ошибка или запрос сформирован некорректно, сервер вернёт код ошибки.
Ниже вы найдете таблицы со списком возможных кодов ошибки:

Ошибки, как и ответы на капчи, возвращаются в виде простого текста, либо в формате JSON, если вы используете параметр json=1.

Вы можете получить список всех ошибок, которые возвращает in.php, отправив вот такой запрос.

В очень редких случаях сервер может вернуть HTML-страницу с ошибкой 500 или 502 — пожалуйста, имейте это в виду и обрабатывайте эту ситуацию корректно.
Если вы получили что-либо, не похожее на ответ ли код ошибки, подождите 5 секунд и отправьте запрос повторно.

Код ошибки Описание Действие

ERROR_WRONG_USER_KEY Вы указали значение параметра key в неверном формате, ключ должен содержать 32 символа. Прекратите отправку запросов и проверьте ваш ключ API.

ERROR_KEY_DOES_NOT_EXIST Ключ, который вы указали, не существует. Прекратите отправку запросов и проверьте ваш ключ API.

ERROR_ZERO_BALANCE На вашем счету недостаточно средств. Прекратите отправку запросов. Пополните баланс вашего счета, чтобы продолжить работу с сервисом.

ERROR_PAGEURL Параметр pageurl не задан в запросе. Остановите отправку запросов и измените ваш код, чтобы передавать правильное значение параметра pageurl.
Подробнее.

ERROR_NO_SLOT_AVAILABLE Вы можете получить данную ошибку в двух случаях:
1. Если решаете капчи с токенами (reCAPTCHA, hCaptcha, ArkoseLabs FunCaptcha, Geetest и т.п.): Очередь ваших капч, которые ещё не распределены на работников, слишком длинная. Длина очереди зависит от общего числа капч, которые ждут распределения, и может иметь значения от 50 до 100 капч.
2. Если решаете обычные капчи: Максимальная ставка, которую вы указали в настройках вашего аккаунта ниже текущей ставки на сервере.
Вы можете повысить вашу максимальную ставку. Если вы получили данную ошибку, не отправляйте ваш запрос повторно сразу же после её получения. Сделайте паузу в 2-3 секунды и попробуйте повторить ваш запрос.

ERROR_ZERO_CAPTCHA_FILESIZE Размер вашего изображения менее 100 байт. Проверьте файл изображения.

ERROR_TOO_BIG_CAPTCHA_FILESIZE Размер вашего изображения более 100 Кбайт либо более 600 пикселей по любой из сторон. Проверьте файл изображения.

ERROR_WRONG_FILE_EXTENSION Файл имеет неподдерживаемое расширение. Допустимые расширения: jpg, jpeg, gif, png. Проверьте файл изображения.

ERROR_IMAGE_TYPE_NOT_SUPPORTED Сервер не может опознать тип вашего файла. Проверьте файл изображения.

ERROR_UPLOAD Сервер не может прочитать файл из вашего POST-запроса.
Это происходит, если POST-запрос некорректно сформирован в части отправки файла, либо содержит невалидный base64. Вам нужно исправить ошибку в коде, осуществляющем загрузку файла.

ERROR_IP_NOT_ALLOWED Запрос отправлен с IP-адреса, который не добавлен в список разрешённых вами IP-адресов. Проверьте список разрешённых IP-адресов.

IP_BANNED Ваш IP-адрес заблокирован за чрезмерное количество попыток авторизации с неверным ключем авторизации. Бан будет автоматически снят через 5 минут.

ERROR_BAD_TOKEN_OR_PAGEURL Вы можете получить эту ошибку, если отправляете нам reCAPTCHA V2. Ошибка возвращается если вы прислали невалидную пару значений googlekey и pageurl. Обычно так бывает, если reCAPTCHA подгружается в iframe с другого домена или поддомена. Внимательно посмотрите на код страницы и найдите правильные значения googlekey и pageurl.

ERROR_GOOGLEKEY Вы можете получить эту ошибку, если отправляете нам reCAPTCHA V2. Ошибка возвращается если sitekey в вашем запросе пустой или имеет некорректный формат. Проверьте ваш код, отвечающий за поиск sitekey и отправку запроса к нашему API.

ERROR_PROXY_FORMAT Вы используете некорректный формат прокси при отправке запроса к in.php Скорректируйте формат прокси в соответствии с описанием в разделе Работа с прокси.

ERROR_WRONG_GOOGLEKEY Параметр googlekey отсутствует в вашем запросе. Проверьте ваш код, отвечающий за поиск sitekey и отправку запроса к нашему API.

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

TOO_MANY_BAD_IMAGES Вы присылаете слишком много изображений, которые невозможно распознать Убедитесь что ваши последние капчи отображатся и читаемы, а также проверьте нераспознаваемые капчи которые мы для вас сохранили. Исправьте ваш софт для того чтобы отправлять изображения правильно.

MAX_USER_TURN Вы делаете больше 60 обращений к in.php в течение 3 секунд.
Ваш ключ API заблокирован на 10 секунд. Блокировка будет снята автоматически. Увеличьте тайм-аут между запросами к in.php до 100 мс.

ERROR: NNNN Где NNNN — номер ошибки.
Вы превысили лимит запросов и ваш аккаунт временно заблокирован. Вам необходимо установить правильные тайм-ауты. Больше информации в главе Лимиты запросов.

ERROR_BAD_PARAMETERS Код ошибки возвращается если в вашем запросе отсутствуют обязательные параметры или значения параметров имеют некорректный формат. А также, если у вас одновременно включен режим SandBox и режим 100% распознавания.
Например, вы присылаете reCAPTCHA в виде картинок без инструкции для работников. Или же присылаете некорректные cookies при решении reCAPTCHA V2 или TikTok Проверьте что ваш запрос содержит все необходимые параметры и они имеют правильный формат.
Используйте режим отладки для проверки параметров, которые нам отправляете.

ERROR_BAD_PROXY Вы можете получить эту ошибку, если ваш прокси-сервер был помечен ПЛОХИМ, т.к. нам не удалось к нему подключиться. Используйте другой прокси-сервер в своих запросах.

ERROR_SITEKEY Вы можете получить эту ошибку, если отправляете нам hCaptcha. Ошибка возвращается если sitekey в вашем запросе пустой или имеет некорректный формат. Проверьте ваш код, отвечающий за поиск sitekey и отправку запроса к нашему API.

Код ошибки Описание Действие

CAPCHA_NOT_READY Ваша капча ещё не решена. Подождите 5 секунд и повторите ваш запрос.

ERROR_CAPTCHA_UNSOLVABLE Мы не можем решить вашу капчу — три наших работника не смогли её решить, либо мы не получили ответ в течение 90 секунд.
Мы не спишем с вас деньги за этот запрос. Вы можете попробовать отправить капчу ещё раз.

ERROR_WRONG_USER_KEY Вы указали значение параметра key в неверном формате, ключ должен содержать 32 символа. Прекратите отправку запросов и проверьте ваш ключ API.

ERROR_KEY_DOES_NOT_EXIST Ключ, который вы указали, не существует. Прекратите отправку запросов и проверьте ваш ключ API.

ERROR_WRONG_ID_FORMAT Вы отправили ID капчи в неправильном формате. ID состоит только из цифр. Проверьте ID вашей капчи или код, который отвечает за получение и отправку ID.

ERROR_WRONG_CAPTCHA_ID Вы отправили неверный ID капчи. Проверьте ID вашей капчи или код, который отвечает за получение и отправку ID.

ERROR_BAD_DUPLICATES Ошибка возвращается, если вы используете функцию 100% распознавания. Ошибка означает, что мы достигли максимального числа попыток, но требуемое количество совпадений достигнуто не было. Вы можете попробовать отправить вашу капчу ещё раз.

ERROR_REPORT_NOT_RECORDED Ошибка возвращается при отправке жалобы на неверный ответ если вы уже пожаловались на большое количество верно решённых капч (более 40%). Или если прошло более 15 минут с момента отправки капчи на решение. Убедитесь, что вы отправляете жалобы только в случае неправильного решения.

ERROR_DUPLICATE_REPORT Ошибка возвращается при отправке отчетов если вы повторно отправляете отчет на одну и ту же капчу. Убедитесь, что вы отправляете отчет на каждую капчу только один раз.

ERROR: NNNN Где NNNN — номер ошибки.
Вы превысили лимит запросов и ваш аккаунт временно заблокирован. Вам необходимо установить правильные тайм-ауты. Больше информации в главе Лимиты запросов.

ERROR_IP_ADDRES Ошибка возвращается при добавлении домена или IP для pingback (callback).
Это происходит, если вы отправляете запрос на добавление IP или домена с IP адреса, не совпадающего с вашим IP или доменом для pingback. Отправьте запрос с того же IP адреса, на который хотите получать pingback.

ERROR_TOKEN_EXPIRED Вы можете получить эту ошибку, если решаете капчу Geetest.
Этот код ошибки означает, что истек срок действия значения challenge из вашего запроса. Попробуйте отправить запрос еще раз. Если вы всегда получаете эту ошибку, значит мы не можем решить Geetest капчу на этом сайте.

ERROR_EMPTY_ACTION Параметр action не был передан или передан без значения. Добавьте в запрос нужный параметр и значение, например, get или getbalance .

ERROR_PROXY_CONNECTION_FAILED Вы можете получить эту ошибку, если нам не удалось загрузить капчу через ваш прокси-сервер. Этот прокси будет помечен ПЛОХИМ и мы не будем принимать запросы с ним в течении 10 минут. А in.php будет возвращать ошибку ERROR_BAD_PROXY при использовании этого прокси. Используйте другой прокси-сервер в своих запросах.

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

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

Метод может использоваться как с in.php так и с res.php с любым запросом.

Добавьте параметр debug_dump=1 к вашему запросу и наш сервер вернет дамп вашего запроса, содержащий все параметры, которые мы от вас получили.

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

Пожалуйста, помните о том, что каждый ваш запрос к нашему API генерирует множество запросов к нашим БД. Поэтому мы просим вас устанавливать правильные тайм-ауты для ваших запросов, а также корректно обрабатывать ошибки в случаях, если сервер возвращает любой вид ошибки или что-либо отличное от ответа или кода ошибки (например, HTML-страницу с ошибкой).

Например:

Если сервер вернул ERROR_NO_SLOT_AVAILABLE — подождите 5 секунд прежде чем отправлять ваш запрос ещё раз.

Если сервер вернул ERROR_ZERO_BALANCE — подождите 60 секунд.

После загрузки капчи подождите как минимум 5 секунд (15-20 для recaptcha) и только потом запрашивайте ответ.

Если капча не решена, отправляйте повторный запрос не ранее чем через 5 секунд.

Если задержки в вашем ПО настроены некорректно, ваш аккаунт или IP-адрес будет временно заблокирован и сервер вернёт числовой код ошибки. По истечени времени блокировки ваш аккаунт будет автоматически разблокирован. Список кодов ошибок приведен в таблице ниже.

Коды ошибок, возвращаемые при установке ограничений для учётной записи

Код ошибки Время блокировки Причина блокировки

ERROR: 1001 10 минут Вы получили 120 ответов ERROR_NO_SLOT_AVAILABLE за одну минуту из-за того, что ваша максимальная ставка ниже, чем текущая ставка на сервере.

ERROR: 1002 5 минут Вы получили 120 ответов ERROR_ZERO_BALANCE за одну минуту из-за того, что на вашем счету недостаточно средств.

ERROR: 1003 30 секунд Вы получаете ответ ERROR_NO_SLOT_AVAILABLE из-за того, что на сервере скопилась большая очередь из ваших капч, которые не распределены работникам.
Вы получили в три раза больше ошибок, чем число капч, которое вы загрузили (но не менее 120 ошибок). Увеличьте тайм-аут, если вы получаете этот код ошибки.

ERROR: 1004 10 минут Ваш IP-адрес заблокирован, потому что мы получили 5 запросов с некорректным ключем API с вашего IP.

ERROR: 1005 5 минут Вы делаете слишком много запросов к res.php для получения ответов.
При блокировке аккаунта используется следующее правило: R > C * 20 + 1200
Где:
R — число ваших запросов
C — число капч, которые вы загрузили
Это означает, что вы не должны обращаться к res.php за ответом для каждой капчи более 20 раз.
Пожалуйста, помните, что запрос баланса к res.php также учитывается!
Чтобы получать ваши ответы быстрее и без риска быть заблокированным, вы можете использовать метод pingback, и мы отправим вам ответ, как только решим вашу капчу.

MAX_USER_TURN 10 секунд Вы делаете больше 60 обращений к in.php в течение 3 секунд. Увеличьте тайм-аут между запросами к in.php до 100 мс.

Прокси могут быть использованы для решения большинства видов javascript-капчи:

reCAPTCHA V2

reCAPTCHA Enterpise V2

Arkose Labs FunCaptcha

Geetest

hCaptcha

TikTok

Прокси позволяют решать капчу с того же IP-адреса, с которого вы обращаетесь к сайту, защищенному капчей.
В большинстве случаев использовать прокси не обязательно. Но, для некоторых видов защиты сайтов вы должны их использовать. Например: страницы защиты Cloudflare и Datadome требуют совпадения IP-адресов.
Кроме того, хорошие прокси с регулярной их ротацией могут повысить скорость и процент успешных решений для Arkose Labs FunCaptcha.

Прокси не поддерживаются при решении reCAPTCHA V3 and Enterprise V3 так как использование прокси в этом случае сильно снижает score полученных токенов.

Если вы отправляете нам данные прокси-сервера, мы проверяем его доступность, пробуя открыть сайт через ваш прокси. Если открыть сайт не получается, мы не будем использовать ваш прокси-сервер.
Если ваш прокси проходит проверку, он будет использован для загрузки reCAPTCHA при её решении.

Мы не имеем собственных прокси-серверов, которые мы могли бы вам предложить, поэтому вы должны использовать сторонние прокси или поднять свой собственный сервер.

Мы поддерживаем следующие виды прокси: SOCKS4, SOCKS5, HTTP, HTTPS с аутенификацией по IP или по логину и паролю.

Если ваш прокси использует авторизацию по IP-адресу, вам необходимо добавить наш IP в список разрешённых адресов:
138.201.188.166

Укажите адрес и порт вашего прокси в качестве значения параметра proxy
Укажите тип вашего прокси в параметре proxytype.

Если ваш прокси использует аутентификацию по логину и паролю, укажите их в параметре proxy.

Параметр POST Тип Обязателен Описание

proxy Строка Нет При аутенификации по IP: IP_адрес:ПОРТ
Пример: proxy=123.123.123.123:3128
При аутенификации по логину и паролю: логин:пароль@IP_адрес:ПОРТ
Пример: proxy=proxyuser:[email protected]:3128

proxytype Строка Нет Тип вашего прокси: HTTP, HTTPS, SOCKS4, SOCKS5.
Пример: proxytype=SOCKS4

Мы предоставляем метод pingback (callback), который позволяет автоматически получить ответ на вашу капчу, когда она решена.
Это дает вам возможность получать ответы, не делая запросов к http://rucaptcha.com/res.php , а также избежать блокировки вашего аккаунта из-за превышения лимита запросов.

Для получения ответов в автоматическом режиме вам необходимо:

Зарегистрировать ваш домен или IP, на который будут отправляться ответы.

Передать ваш URL для отправки ответа в параметре pingback вашего запроса к http://rucaptcha.com/in.php .

Обработать запрос HTTP POST, который приходит от нашего сервера на ваш URL. Данные в запросе приходят как URLencoded FormData (application/x-www-form-urlencoded). Запрос содержит два параметра: id (ID вашей капчи) и code — ответ на нее.

Incoming pingback request example:

Вы можете использовать любой URL на зарегистрированом домене или IP и URL может включать ваши собственные параметры.
Но, тут есть одно ограничение: если вы отправляете капчу GET-запросом, а ваш URL для pingback включает несколько параметров, например http://mysite.com/pingback/?myId=1&myCat=2&something_else=test то сохранится только первый из них ?myId=1 . Чтобы этого избежать, используйте POST-запрос с multipart/form-data.

Вы можете управлять вашими зарегистрированными доменами и IP на странице управления адресами pingback или с помощью HTTP GET запросов к http://rucaptcha.com/res.php
Параметры запросов описаны в таблице ниже.

Важно: Домен или IP может быть добавлен только с того же самого IP адреса, на который он указывает.

Список параметров GET запросов к http://rucaptcha.com/res.php

Параметр GET Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да add_pingback — зарегистрировать новый URL
get_pingback — получить список зарегистрированных URL
del_pingback — удалить URL

addr Строка — Ваш URL для отправки ответа.
Например: http://mysite.com/pingback/url/ или 123.123.123.123/pingback/url/
Вы можете использовать значение all совместно с del_pingback для удаления всех URL.

json Число
По умолчанию: 0 Нет 0 — сервер отправит ответ в виде простого текста
1 — сервер отправит ответ в формате JSON

Добавить новый IP или домен:

Получить список зарегистрированных IP или доменов:

Удалить всех зарегистрированные IP или домены:

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

Мы рекомендуем сообщать как о неправильных ответах, так и о правильных.

Если ответ не был принят сайтом, используйте метод reportbad чтобы сообщить нам об этом. Мы перепроверим ответ и вернем деньги за неправильный ответ на ваш баланс.

Если же ответ был успешно принят — используйте метод reportgood . Это позволит нам повысить точность для будущих запросов.

Важно: не пытайтесь отправлять отчеты reportbad на верные ответы. Если вы будете это делать, то мы заблокируем вам возможность использования этого метода..

Отчеты для капч с токеном, таких как reCAPTCHA V2/V3, KeyCaptcha, FunCaptcha не видны в интерфейсе на сайте. Но мы собираем статистику по всем таким отчетам для повышения качества решений.

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

Примеры запросов:

Список параметров GET запроса к http://rucaptcha.com/res.php

Параметр GET Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да get — получить ответ на капчу
reportgood — сообщить о верном ответе
reportbad — сообщить о неверном ответе

id Строка Да ID капчи

json Число
По умолчанию: 0 Нет 0 — сервер отправит ответ в виде простого текста
1 — сервер отправит ответ в формате JSON

В ответ на ваш запрос сервер ответит OK_REPORT_RECORDED или вернёт код ошибки, если что-то не так.

Если вы получаете слишком много неверных ответов, вы можете указать дополнительные параметры вашей капчи, чтобы помочь нашим работникам решить её правильно.

Вы можете получить дополнительную информацию от нашего API, например, баланс вашего счета.
Список дополнительных параметров приведён ниже.

Список параметров GET запросов для http://rucaptcha.com/res.php

Параметр GET Тип Обязателен Описание

key Строка Да ваш ключ API

action Строка Да getbalance — получить ваш баланс
date parameter.
Server will return the report as XML file.
—> get — получить ответы на множество капч с помощью одного запроса. Требует указания параметра ids.
get2 — получить стоимость решения отправленной капчи и ответ на нее. Требует указания ID капчи в параметре id.

ids Строка — ID ваших капч, разделенные запятыми.

id Строка — ID вашей капчи.

json Число
По умолчанию: 0 Нет 0 — сервер отправит ответ в виде простого текста
1 — сервер отправит ответ в формате JSON

Пример запроса (простой текст):

Пример ответа (простой текст):

Пример запроса (JSON):

Пример ответа (JSON):

Еще больше примеров кода можно всегда найти поиском rucaptcha OR 2captcha по GitHub. Если код сделан для 2captcha.com, просто замените URL на rucaptcha.com, API абсолютно идентичен.

Важно: в примерах кода могут использоваться URL серверов 2captcha.com, вам необходимо изменить их на rucaptcha.com. Вы не сможете получить ответ на вашу капчу, если отправили её на 2captcha.com, а ответ запрашиваете у rucaptcha.com.

Мы предоставляем режим песочницы (sandbox), в котором вы можете видеть и самостоятельно решать ваши капчи. Он может помочь вам в тестировании вашего ПО. Не забудьте его отключить, если вы хотите, чтобы капчи решались нашими работниками.
Вы можете включить этот режим в настройках аккаунта.

При включении режима Sandbox отправляемые на наш сервер капчи не будут распределены работникам.

Обычная капча будет доступна в интерфейсе работника

Капчи с токенами, такие как reCAPTCHA V2, hCaptcha, Geetest, и т.п. доступны в приложении работника

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

reCAPTCHA V3 не поддерживается в режиме SandBox и будет отдана на решение работникам.

Источник

Adblock
detector

Источник

POST параметр	Тип	Обязателен	Описание
key	Строка	Да	ваш ключ API
method	Строка	Да	post — говорит о том, что вы отправляете изображение с помощью multipart-фомы base64 — говорит о том, что вы отправляете изображение в формате base64
file	Файл	Да*	Файл изображения. * — обязателен, если вы отправляете картинку как файл (method=post)
body	Строка	Да*	Изображение, закодированное в формат Base64, * — обязателен, если вы отправляете картинку в Base64 (method=base64)
phrase	Число По умолчанию: 0	Нет	0 — капча состоит из одного слова 1 — капча состоит из двух или более слов
regsense	Число По умолчанию: 0	Нет	0 — капча не чувствительна к регистру 1 — капча чувствительна к регистру
numeric	Число По умолчанию: 0	Нет	0 — не определено 1 — капча состоит только из цифр 2 — капча состоит только из букв 3 — капча состоит либо только из букв, либо только из цифр 4 — в капче ДОЛЖНЫ быть и буквы, и цифры
calc	Число По умолчанию: 0	Нет	0 — не определено 1 — капча требует совершения математического действия (например: напишите результат 4 + 8 = )
min_len	Число По умолчанию: 0	Нет	0 — не определено 1..20 — минимальное количетсво символов в ответе
max_len	Число По умолчанию: 0	Нет	0 — не определено 1..20 — максимальное количетсво символов в ответе
language	Число По умолчанию: 0	Нет	0 — не определено 1 — капча содержит только кириллицу 2 — капча содержит только латиницу
lang	Строка	Нет	Код языка. См. список поддерживаемых языков.
textinstructions	Строка Максимум 140 символов Кодировка: UTF-8	Нет	Текст будет показан работнику, чтобы помочь ему правильно решить капчу. Например: введите только красные буквы.
imginstructions	Изображение Макс. 450x150px, 100 Кбайт	Нет	Изображение будет показано работнику, чтобы помочь ему решить капчу правильно. Сервер принимает изображения в формате multipart или base64.
header_acao	Число По умолчанию: 0	Нет	0 — выключен 1 — включен Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ. Используется для кроссдоменных AJAX-запросов из веб-приложений.
pingback	Строка	Нет	URL для автоматической отправки ответа на капчу (callback). URL должен быть зарегистрирован на сервере. Больше информации здесь.
json	Число По умолчанию: 0	Нет	0 — сервер вернёт ответ в виде простого текста 1 — сервер вернёт ответ в формате JSON
soft_id	Число	Нет	ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.

GET параметр	Тип	Обязателен	Описание
key	Строка	Да	ваш ключ API
action	Строка	Да	get — получить ответ на капчу
id	Число	Да	ID капчи, полученный от in.php.
json	Число По умолчанию: 0	Нет	0 — сервер вернёт ответ в виде простого текста 1 — сервер вернёт ответ в формате JSON
header_acao	Число По умолчанию: 0	Нет	0 — выключен 1 — включен Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ. Используется для кроссдоменных AJAX-запросов из веб-приложений.

Параметр	Тип	Обязателен	Описание
key	Строка	Да	ваш ключ API
method	Строка	Да	userrecaptcha — определяет, что вы решаете reCAPTCHA V2 с помощью нового метода
googlekey	Строка	Да	Значение параметра k или data-sitekey, которое вы нашли в коде страницы
pageurl	Строка	Да	Полный URL страницы, на которой вы решаете reCAPTCHA V2
domain	Строка По умолчанию: google.com	Нет	Домен, с которого загружается reCAPTCHA: recaptcha.net или google.com
invisible	Число По умолчанию: 0	Нет	1 — говорит нам, что на сайте невидимая reCAPTCHA. 0 — обычная reCAPTCHA.
data-s	Строка	Нет	Значение параметра data-s найденное на странице. Актуально для поиска в Google и других сервисов Google.
cookies	Строка	Нет	Ваши cookies которые будут использованы работником для решения капчи. В ответе на капчу мы вернем cookies работника, но только при использовании json=1 . Формат: КЛЮЧ:Значение, разделитель — точка с запятой, например: KEY1:Value1;KEY2:Value2;
userAgent	Строка	Нет	Подставляем у работника ваш userAgent
header_acao	Число По умолчанию: 0	Нет	0 — выключен 1 — включен Если включен, то in.php добавит заголовок Access-Control-Allow-Origin:* в ответ. Используется для кроссдоменных AJAX-запросов из веб-приложений.
pingback	Строка	Нет	URL для автоматической отправки ответа на капчу (callback). URL должен быть зарегистрирован на сервере. Больше информации здесь.
json	Число По умолчанию: 0	Нет	0 — сервер вернёт ответ в виде простого текста 1 — сервер вернёт ответ в формате JSON
soft_id	Число	Нет	ID разработчика ПО. Разработчики, интегрировавшие свое ПО с нашим сервисом, получают 10% от стоимости каждого такого запроса.
proxy	Строка	Нет	Формат: логин:пароль@123.123.123.123:3128 Больше информации о прокси здесь.
proxytype	Строка	Нет	Тип вашего прокси-сервера: HTTP, HTTPS, SOCKS4, SOCKS5.

Код языка (значение lang )	Язык
en	Английский
ru	Русский
es	Испанский
pt	Португальский
uk	Украинский
vi	Вьетнамский
fr	Французский
id	Индонезийский
ar	Арабский
ja	Японский
tr	Турецкий
de	Немецкий
zh	Китайский
fil	Филиппинский
pl	Польский
th	Тайский
it	Итальянский
nl	Нидерландский
sk	Словацкий
bg	Болгарский
ro	Румынский
hu	Венгерский
ko	Корейский
cs	Чешский
az	Азербайджанский
fa	Персидский (Фарси)
bn	Бенгальский
el	Греческий
lt	Литовский
lv	Латышский
sv	Шведский
sr	Сербский
hr	Хорватский
he	Иврит
hi	Хинди
nb	Норвежский
sl	Словенский
da	Датский
uz	Узбекский
fi	Финский
ca	Каталонский
ka	Грузинский
ms	Малайский
te	Телугу
et	Эстонский
ml	Малаялам
be	Белорусский
kk	Казахский
mr	Маратхи
ne	Непальский
my	Бирманский
bs	Боснийский
hy	Армянский
mk	Македонский
pa	Панджаби

Код ошибки	Описание	Действие
ERROR_WRONG_USER_KEY	Вы указали значение параметра key в неверном формате, ключ должен содержать 32 символа.	Прекратите отправку запросов и проверьте ваш ключ API.
ERROR_KEY_DOES_NOT_EXIST	Ключ, который вы указали, не существует.	Прекратите отправку запросов и проверьте ваш ключ API.
ERROR_ZERO_BALANCE	На вашем счету недостаточно средств.	Прекратите отправку запросов. Пополните баланс вашего счета, чтобы продолжить работу с сервисом.
ERROR_PAGEURL	Параметр pageurl не задан в запросе.	Остановите отправку запросов и измените ваш код, чтобы передавать правильное значение параметра pageurl. Подробнее.
ERROR_NO_SLOT_AVAILABLE	Вы можете получить данную ошибку в двух случаях: 1. Если решаете капчи с токенами (reCAPTCHA, hCaptcha, ArkoseLabs FunCaptcha, Geetest и т.п.): Очередь ваших капч, которые ещё не распределены на работников, слишком длинная. Длина очереди зависит от общего числа капч, которые ждут распределения, и может иметь значения от 50 до 100 капч. 2. Если решаете обычные капчи: Максимальная ставка, которую вы указали в настройках вашего аккаунта ниже текущей ставки на сервере. Вы можете повысить вашу максимальную ставку.	Если вы получили данную ошибку, не отправляйте ваш запрос повторно сразу же после её получения. Сделайте паузу в 2-3 секунды и попробуйте повторить ваш запрос.
ERROR_ZERO_CAPTCHA_FILESIZE	Размер вашего изображения менее 100 байт.	Проверьте файл изображения.
ERROR_TOO_BIG_CAPTCHA_FILESIZE	Размер вашего изображения более 100 Кбайт либо более 600 пикселей по любой из сторон.	Проверьте файл изображения.
ERROR_WRONG_FILE_EXTENSION	Файл имеет неподдерживаемое расширение. Допустимые расширения: jpg, jpeg, gif, png.	Проверьте файл изображения.
ERROR_IMAGE_TYPE_NOT_SUPPORTED	Сервер не может опознать тип вашего файла.	Проверьте файл изображения.
ERROR_UPLOAD	Сервер не может прочитать файл из вашего POST-запроса. Это происходит, если POST-запрос некорректно сформирован в части отправки файла, либо содержит невалидный base64.	Вам нужно исправить ошибку в коде, осуществляющем загрузку файла.
ERROR_IP_NOT_ALLOWED	Запрос отправлен с IP-адреса, который не добавлен в список разрешённых вами IP-адресов.	Проверьте список разрешённых IP-адресов.
IP_BANNED	Ваш IP-адрес заблокирован за чрезмерное количество попыток авторизации с неверным ключем авторизации.	Бан будет автоматически снят через 5 минут.
ERROR_BAD_TOKEN_OR_PAGEURL	Вы можете получить эту ошибку, если отправляете нам reCAPTCHA V2. Ошибка возвращается если вы прислали невалидную пару значений googlekey и pageurl. Обычно так бывает, если reCAPTCHA подгружается в iframe с другого домена или поддомена.	Внимательно посмотрите на код страницы и найдите правильные значения googlekey и pageurl.
ERROR_GOOGLEKEY	Вы можете получить эту ошибку, если отправляете нам reCAPTCHA V2. Ошибка возвращается если sitekey в вашем запросе пустой или имеет некорректный формат.	Проверьте ваш код, отвечающий за поиск sitekey и отправку запроса к нашему API.
ERROR_PROXY_FORMAT	Вы используете некорректный формат прокси при отправке запроса к in.php	Скорректируйте формат прокси в соответствии с описанием в разделе Работа с прокси.
ERROR_WRONG_GOOGLEKEY	Параметр googlekey отсутствует в вашем запросе.	Проверьте ваш код, отвечающий за поиск sitekey и отправку запроса к нашему API.
ERROR_CAPTCHAIMAGE_BLOCKED	Вы отправили изображение, которые помечено в нашей базе данных как нераспознаваемое. Обычно это происходит, если сайт, на котором вы решаете капчу, прекратил отдавать вам капчу и вместо этого выдает изображение с информацией о блокировке.	Попробуйте обойти ограничения этого сайта.
TOO_MANY_BAD_IMAGES	Вы присылаете слишком много изображений, которые невозможно распознать	Убедитесь что ваши последние капчи отображатся и читаемы, а также проверьте нераспознаваемые капчи которые мы для вас сохранили. Исправьте ваш софт для того чтобы отправлять изображения правильно.
MAX_USER_TURN	Вы делаете больше 60 обращений к in.php в течение 3 секунд. Ваш ключ API заблокирован на 10 секунд. Блокировка будет снята автоматически.	Увеличьте тайм-аут между запросами к in.php до 100 мс.
ERROR: NNNN	Где NNNN — номер ошибки. Вы превысили лимит запросов и ваш аккаунт временно заблокирован.	Вам необходимо установить правильные тайм-ауты. Больше информации в главе Лимиты запросов.
ERROR_BAD_PARAMETERS	Код ошибки возвращается если в вашем запросе отсутствуют обязательные параметры или значения параметров имеют некорректный формат. А также, если у вас одновременно включен режим SandBox и режим 100% распознавания. Например, вы присылаете reCAPTCHA в виде картинок без инструкции для работников. Или же присылаете некорректные cookies при решении reCAPTCHA V2 или TikTok	Проверьте что ваш запрос содержит все необходимые параметры и они имеют правильный формат. Используйте режим отладки для проверки параметров, которые нам отправляете.
ERROR_BAD_PROXY	Вы можете получить эту ошибку, если ваш прокси-сервер был помечен ПЛОХИМ, т.к. нам не удалось к нему подключиться.	Используйте другой прокси-сервер в своих запросах.
ERROR_SITEKEY	Вы можете получить эту ошибку, если отправляете нам hCaptcha. Ошибка возвращается если sitekey в вашем запросе пустой или имеет некорректный формат.	Проверьте ваш код, отвечающий за поиск sitekey и отправку запроса к нашему API.

Код ошибки	Время блокировки	Причина блокировки
ERROR: 1001	10 минут	Вы получили 120 ответов ERROR_NO_SLOT_AVAILABLE за одну минуту из-за того, что ваша максимальная ставка ниже, чем текущая ставка на сервере.
ERROR: 1002	5 минут	Вы получили 120 ответов ERROR_ZERO_BALANCE за одну минуту из-за того, что на вашем счету недостаточно средств.
ERROR: 1003	30 секунд	Вы получаете ответ ERROR_NO_SLOT_AVAILABLE из-за того, что на сервере скопилась большая очередь из ваших капч, которые не распределены работникам. Вы получили в три раза больше ошибок, чем число капч, которое вы загрузили (но не менее 120 ошибок). Увеличьте тайм-аут, если вы получаете этот код ошибки.
ERROR: 1004	10 минут	Ваш IP-адрес заблокирован, потому что мы получили 5 запросов с некорректным ключем API с вашего IP.
ERROR: 1005	5 минут	Вы делаете слишком много запросов к res.php для получения ответов. При блокировке аккаунта используется следующее правило: R > C * 20 + 1200 Где: R — число ваших запросов C — число капч, которые вы загрузили Это означает, что вы не должны обращаться к res.php за ответом для каждой капчи более 20 раз. Пожалуйста, помните, что запрос баланса к res.php также учитывается! Чтобы получать ваши ответы быстрее и без риска быть заблокированным, вы можете использовать метод pingback, и мы отправим вам ответ, как только решим вашу капчу.
MAX_USER_TURN	10 секунд	Вы делаете больше 60 обращений к in.php в течение 3 секунд. Увеличьте тайм-аут между запросами к in.php до 100 мс.

Параметр POST	Тип	Обязателен	Описание
proxy	Строка	Нет	При аутенификации по IP: IP_адрес:ПОРТ Пример: proxy=123.123.123.123:3128 При аутенификации по логину и паролю: логин:пароль@IP_адрес:ПОРТ Пример: proxy=proxyuser:[email protected]:3128
proxytype	Строка	Нет	Тип вашего прокси: HTTP, HTTPS, SOCKS4, SOCKS5. Пример: proxytype=SOCKS4

Параметр GET	Тип	Обязателен	Описание
key	Строка	Да	ваш ключ API
action	Строка	Да	add_pingback — зарегистрировать новый URL get_pingback — получить список зарегистрированных URL del_pingback — удалить URL
addr	Строка	—	Ваш URL для отправки ответа. Например: http://mysite.com/pingback/url/ или 123.123.123.123/pingback/url/ Вы можете использовать значение all совместно с del_pingback для удаления всех URL.
json	Число По умолчанию: 0	Нет	0 — сервер отправит ответ в виде простого текста 1 — сервер отправит ответ в формате JSON