API captcha24




Важно: API captcha24 полностью соответствует API аналогичных систем (antigate, pixodrom и другие), но при этом содержит дополнительные методы, не конфликтующие с существующим стандартом.

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

Сервис captcha24 позволяет присылать каптчи и получать их расшифровку в автоматизированном режиме. Для этого понадобится получить api-key в настройках и реализовать следующий алгоритм:

1. Прислать картинку на сервер captcha24.com
2. Получить ID присланной картинки
3. Запустить цикл, который будет проверять поступление расшифровки
4. Если ответ верный - завершить транзакцию
5. Если ответ не верный - отправить уведомление о неверной расшифровке и завершить транзакцию

Загрузка каптчи

Загрузка каптчи возможна в двух форматах:

multipart и base64

Пример загрузки в формате multipart:

<form method="post" action="http://captcha24.com/in.php" enctype="multipart/form-data">
<input type="hidden" name="method" value="post">
Ключ от учетной записи:
<input type="text" name="key" value="YOUR_APIKEY">
Файл каптчи:
<input type="file" name="file">
<input type="submit" value="загрузить и получить ID">
</form>

 

YOUR_APIKEY - Ваш key, длиной 32 символа

Пример загрузки каптчи в формате base64:

<form method="post" action="http://captcha24.com/in.php">
<input type="hidden" name="method" value="base64">
Ключ от учетной записи:
<input type="text" name="key" value="YOUR_APIKEY">
Тело файла каптчи закодированное в base64:
<textarea name="body">BASE64_FILE</textarea>
<input type="submit" value="загрузить и получить ID">
</form>

YOUR_APIKEY - Ваш key, длиной 32 символа

BASE64_FILE - Тело файла закодированное в base64. Не забудьте дополнительно закодировать тело в UUEncode, иначе тело каптчи придет битым.


Дополнительные параметры загрузки каптчи



 

POST параметр возможные значения описание параметра
phrase 0;1 0 = одно слово (значение по умолчанию)
1 = каптча имеет два слова
regsense 0;1 0 = регистр ответа не имеет значения (значение по умолчанию )
1 = регистр ответа имеет значение
numeric 0;1

0 = параметр не задействован (значение по умолчанию)
1 = каптча состоит только из цифр

calc 0;1 0 = параметр не задействован (значение по умолчанию)
1 = работнику нужно совершить математическое действие с каптчи
min_len 0..20

0 = параметр не задействован (значение по умолчанию)
1..20 = минимальное количество знаков в ответе

max_len 1..20 0 = параметр не задействован (значение по умолчанию)
1..20 = максимальное количество знаков в ответе
is_russian 0;1

параметр больше не используется, т.к. он означал "отправлять текущую каптчу русским исполнителям", а в системе находятся только русскоязычные исполнители. Смотрите новый параметр language, однозначно обозначающий язык каптчи

soft_id   ID разработчика приложения. Разработчику приложения отчисляется 10% от всех каптч, пришедших из его приложения.
language 0;1 0 = параметр не задействован (значение по умолчанию)
1 = на каптче только кириллические буквы
header_acao 0;1 0 = значение по умолчанию
1 = in.php передаст Access-Control-Allow-Origin: * параметр в заголовке ответа. Необходимо, для кросс-доменных AJAX запросов в браузерных приложениях. Работает также для res.php.

Ответы сервера на загрузку каптчи:

Ответ сервера Статус Расшифровка
OK|%CAPTCHA_ID%  принято Каптча добавлена в очередь на расшифровку.
%CAPTCHA_ID% - ID каптчи, который Вам понадобится при запросе статуса расшифровки каптчи
ERROR_WRONG_USER_KEY отказано Неверный формат параметра key, должно быть 32 символа
ERROR_KEY_DOES_NOT_EXIST отказано Использован несуществующий key
ERROR_ZERO_BALANCE отказано Баланс Вашего аккаунта нулевой
ERROR_NO_SLOT_AVAILABLE отказано Нет свободных работников.
ERROR_ZERO_CAPTCHA_FILESIZE отказано Размер каптчи меньше 100 Байт
ERROR_TOO_BIG_CAPTCHA_FILESIZE отказано Размер каптчи более 100 КБайт
ERROR_WRONG_FILE_EXTENSION отказано Ваша каптча имеет неверное расширение, допустимые расширения jpg,jpeg,gif,png
ERROR_IMAGE_TYPE_NOT_SUPPORTED отказано Сервер не может определить тип файла каптчи
ERROR_IP_NOT_ALLOWED отказано В Вашем аккаунте настроено ограничения по IP с которых можно делать запросы. И IP, с которого пришёл данный запрос не входит в список разрешённых.
IP_BANNED отказано IP-адрес, с которого пришёл запрос, заблокирован из-за частых обращений с различными неверными ключами. Блокировка снимается по письму на support@captcha24.com

Получение результата расшифровки каптчи:

Делается GET запросом вида:

http://captcha24.com/res.php?key=YOUR_APIKEY&action=get&id=CAPCHA_ID

YOUR_APIKEY - Ваш key, длиной 32 символа
CAPTCHA_ID - ID ранее загруженной каптчи

Ответы сервера:

Ответ сервера на запрос статуса Статус расшифровка
OK|%TEXT% готово Каптча успешно расшифрована
%TEXT% - расшифрованный текст
CAPCHA_NOT_READY ещё не готово Каптча, ещё не расшифрована, необходимо повторить запрос через несколько секунд
ERROR_KEY_DOES_NOT_EXIST ошибка Вы использовали неверный key в запросе
ERROR_WRONG_ID_FORMAT ошибка Неверный формат ID каптчи. ID должен содержать только цифры
ERROR_CAPTCHA_UNSOLVABLE ошибка Каптчу не смогли разгадать 3 разных работника. Средства за эту каптчу не списываются

 

 

Дополнительные возможности API

 

 

Запрос Варианты ответа Расшифровка
action=get&ids=CAPTCHA_ID_1,CAPTCHA_ID_2,...,CAPTCHA_ID_N
 
%TEXT_1%|%TEXT_2%...%TEXT_N% Запрос статуса сразу нескольких каптч. Распознанный текст либо код CAPCHA_NOT_READY будут в этом случае разделены знаком "|"
action=get2&id=CAPCHA_ID
 
%OK%|%TEXT%|%COST% Запрос статуса и стоимости распознавания данной каптчи.
action=reportbad&id=CAPCHA_ID OK_REPORT_RECORDED Пожаловаться на неправильно расшифрованную каптчу
action=getbalance %BALANCE% Узнать баланс аккаунта.
action=getstats&date=2013-11-27 %FILE.XML% получить статистику использования аккаунта в XML за указанную дату
http://captcha24.com/load.php 5 88.3 0.001 14.965648650099 waiting: количество работников ожидающих каптчу.
load: процент загрузки работников
minbid: текущая ставка за распознание каптчи.
averageRecognitionTime: среднее время (в секундах) за которое в данный момент разгадываются каптчи