Описание

Библиотека предназначена для того, чтобы облегчить работу с API RuCaptca.ru в языке java.

Библиотека RuCaptchaAPI.jar

Библиотека содержит два класса:

  • RuCaptcha (основной класс, содержащий непосредственно методы для работы с сервисом)

  • Utility (вспомогательный класс, содержащий дополнительные методы, которые могут пригодиться в работе)

Класс RuCaptcha

Класс содержит поля

 

public static String API_KEY;

Ваш api_key в системе. Указывается перед началом работы с системой. 

 

Класс содержит следующие методы

 

public static String getBalance()

Запрос баланса у сервиса. Возвращает ответ системы в виде строки.

 

public static String systemLoad()

Запрос состояния загрузки системы.

Возвращает ответ системы в виде строки.

 

public static String getCost(String CAPCHA_ID)

Запрос статуса и стоимости распознования данной капчи.

Возвращает ответ системы в виде строки.

 

public static String getDecryption(String CAPCHA_ID)

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

 

public static String reportBad(String CAPCHA_ID)

Пожаловаться на неправильно расшифрованную капчу.

 

public static String postCaptcha(File imgFile)

Загрузка капчи. В качестве параметра указывается переменная типа File к изображению капчи. 

Также имеются производные методы с дополнительными параметрами.

 

public static String postReCaptcha2(File imgFile, String textInstructions, int languageInstructions)

Загрузка капчи ReCaptcha v2 (ASIRA).

 

public static String postReCaptcha2(File imgFile, String textInstructions, int languageInstructions, int recaptchacols, int recaptcharows)

Загрузка капчи ReCaptcha v2 (ASIRA) с указанием количества колонок и строк.

 

Update 07.04.2016

Дабавлен функционал для работы с адресами обратного пинга.

    //Добавление IP
    public static String addPingback(String address)

 

 

    //Получение всех ардесов добавленых на обратный пинг
    public static String getPingback()

 

 

    //Удаление адреса
    public static String delPingback(String address)

 

 

    //Удаление всех привязанных адресов
    public static String delAllPingback()

 

Добавлены производные методы загрузки каптчи с параметром: 

    //Для указания, куда именно должен ответить сервер, при отправке изображения
    String pingback.

 

Update 29.04.2016

Добавлены производные методы загрузки рекапча с параметром: 

    //При отправке этого параметра у работников появляется кнопка "нет подходящих картинок". В случае, когда работник нажимает эту кнопку, Вы получаете ответ:  No_matching_images
    int can_no_answer.

 

Update 15.05.2016

Добавлены производные методы загрузки рекапча с параметром: 

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

 

Добавлены методы загрузки audio-версии рекапчи: 

    //Audio Recaptcha v2 + audio SolveMedia.
    postAudioCaptcha(File mp3File, CaptchaType captchaType)

Update 15.11.2016

Добавлены производные методы загрузки рекапча без эмуляции браузера: 

    postReCaptcha2(String googlekey)

    postReCaptcha2(String googlekey, String proxy, ProxyType proxytype)

    postReCaptcha2(String googlekey, String pageurl)

    postReCaptcha2(String googlekey, String pageurl, String proxy, ProxyType proxytype)

 

Добавлены методы для работы с JSON: 

    //метод активирует json параметр и все имеющиеся методы работы с ruCapcha станут возвращать результаты в формате json (подробней о формате читайте на сайте rucaptcha.com).
    enableJson()

    //метод отключает формат json в результатах.

    disableJson()

    //метод возвращает true, если формат json подключен.

    isJsonEnable()

В тестовом режиме добавлены методы для конфигурации Proxy в класс Utility библиотеки: 

    httpProxyConfig(String proxyHost, String proxyPort)

    httpProxyConfig(String proxyHost, String proxyPort, String proxyUser, String                                                       proxyPassword)

    httpsProxyConfig(String proxyHost, String proxyPort)

    httpsProxyConfig(String proxyHost, String proxyPort, String proxyUser, String                                                       proxyPassword)

RuCaptcha-0.8.2.jar

 

jar-библиотека для работы с сервисом RuCaptcha.ru

Предыдущие версии

Бизнес-план

от А до Я

 
БЕСПЛАТНЫЙ ТРЕНИНГ
(оценивается в 10 000 руб.)
 

Узнайте все что нужно для написания бизнес-плана для вашего предприятия!

Подключение

  1. Первым делом нужно скачать jar-библиотеку с этого сайта.

  2. Подключить библиотеку к проекту.

  3. И импортировать ее 

import net.marketer.RuCaptcha;

Примеры использования

        File imgFile = new File("путь к изображению капчи");
        RuCaptcha.API_KEY = "fdg998fsffdbg9b0bsd0sdf";
        String CAPCHA_ID;
        String decryption;

 

        String response = RuCaptcha.postCaptcha(imgFile);


        if (response.startsWith("OK")) {
            CAPCHA_ID = response.substring(3);

            while (true){
                response = RuCaptcha.getDecryption(CAPCHA_ID);
                if(response.equals(RuCaptcha.Responses.CAPCHA_NOT_READY.toString())){
                    Thread.sleep(5000);
                    continue;
                }else if(response.startsWith("OK")){
                    decryption = response.substring(3);
                    break;
                }else {
                    //обработка ошибок
                }
            }
            
            //ваш код использования полученной расшифровки капчи
                        
        }