Логотип «2Captcha»Перейти на головну сторінку
  • Логотип «PHP»
  • Логотип «Python»
  • Логотип «Java»
  • Логотип «C#»
  • Логотип «Ruby»
  • Логотип «Golang»
  • Логотип «JavaScript»
Обхід капчі на Java

Обхід капчі на Java
Логотип «Java»
  • Логотип «PHP»
  • Логотип «Python»
  • Логотип «Java»
  • Логотип «C#»
  • Логотип «Ruby»
  • Логотип «Golang»
  • Логотип «JavaScript»

Використовуйте бібліотеку Java для швидкого розв'язування та обходу капчі. Сервіс надає простий API для розв'язання капчі.

Пакет Java бібліотек для простої інтеграції з API сервісу розв'язування капчі 2Captcha для обходу reCAPTCHA, Arkose captcha, Geetest та рішення будь-яких інших капч

Швидкий старт

Встановлення

Пакет скриптів можна встановити за допомогою інсталятора пакетів або вручну

Maven Central Repository

Артефакт 2captcha-java доступний у Maven Central

Приклади коду, а також бібліотеки та модулі для інтеграції з нашим API ви можете знайти в репозиторії на GitHub.

Конфігурація

Опис усіх потрібних параметрів для конфігурування встановленого пакета

Примірник класу TwoCaptcha можна створити так:

TwoCaptcha solver = new TwoCaptcha('YOUR_API_KEY');

Також у вас є можливість настроювати деякі опції створеного екземпляра:

solver.setSoftId(123);
solver.setCallback("https://your.site/result-receiver");
solver.setDefaultTimeout(120);
solver.setRecaptchaTimeout(600);
solver.setPollingInterval(10);
Опції екземпляра TwoCaptcha
ОпціяЗначення за замовчуваннямОпис
softId-ваш ID програмного забезпечення, отриманий після публікації в каталог програм 2Captcha
callback-URL вашого веб-сервера, який отримує результат розпізнавання капчі. URL повинен бути спочатку зареєстрований у налаштуваннях pingback вашого облікового запису
defaultTimeout120Таймаут опитування за секунди для всіх типів капчі, крім reCAPTCHA. Визначає, як довго модуль намагається отримати відповідь кінцевої точки API res.php
recaptchaTimeout600Таймаут опитування reCAPTCHA за секунди. Визначає, як довго модуль намагається отримати відповідь кінцевої точки API res.php
pollingInterval10Інтервал у секундах між запитами до кінцевої точки API res.php, встановлення значень менше 5 секунд не рекомендується
ВАЖЛИВО: як тільки callback визначено для одного екземпляра класу TwoCaptcha, всі інші методи повертають тільки ID капчі та НЕ опитують API для отримання результату. Результат буде надіслано на Callback URL. Щоб отримати відповідь вручну, використовуйте метод getResult

Рішення капчі

Коли ви відправляєте будь-яку графічну капчу, ви можете передавати додаткові параметри, які допоможуть працівникам 2Captcha вирішити її швидко та правильно.

Опції капчі
ОпціяЗначення за замовчуваннямОпис
numeric0визначає, чи містить капча числові або інші символи, докладніше див. у документації API
minLength0мінімальна довжина відповіді
maxLength0максимальна довжина відповіді
phrase0визначає, чи містить відповідь кілька слів чи ні
caseSensitive0визначає, чи чутлива відповідь до регістру
calc0визначає капчу, яка потребує розрахунку
lang-визначає мову капчі, дивіться список мов, що підтримуються
hintImg-зображення з підказкою, показане працівникам за допомогою капчі
hintText-підказка або текст завдання, що показується працівникам за допомогою капчі

Базовий приклад

У наведеному нижче прикладі наведено базовий приклад виклику розв'язувача з обробкою помилок.

Normal captcha = new Normal();
captcha.setFile("path/to/captcha.jpg");
captcha.setMinLen(4);
captcha.setMaxLen(20);
captcha.setCaseSensitive(true);
captcha.setLang("en");

try {
    solver.solve(captcha);
    System.out.println("Captcha solved: " + captcha.getCode());
} catch (Exception e) {
    System.out.println("Error occurred: " + e.getMessage());
}
simpleCaptcha

Щоб обійти звичайну капчу (перекручений текст на зображенні), використовуйте наступний метод. Цей метод можна також використовувати для розпізнавання будь-якого тексту на зображенні.

Normal captcha = new Normal();
captcha.setFile("path/to/captcha.jpg");
captcha.setNumeric(4);
captcha.setMinLen(4);
captcha.setMaxLen(20);
captcha.setPhrase(true);
captcha.setCaseSensitive(true);
captcha.setCalc(false);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Type red symbols only");
textCaptcha

Цей метод можна використовувати для обходу капчі, яка вимагає відповіді на запитання у вигляді відкритого тексту

Text captcha = new Text();
captcha.setText("If tomorrow is Saturday, what day is today?");
captcha.setLang("en");
recaptchaV2

Використовуйте цей метод для вирішення reCAPTCHA V2 та отримання токена для обходу захисту

ReCaptcha captcha = new ReCaptcha();
captcha.setSiteKey("6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-");
captcha.setUrl("https://mysite.com/page/with/recaptcha");
captcha.setInvisible(true);
captcha.setAction("verify");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
recaptchaV3

Цей метод дозволяє обходити reCAPTCHA V3 та повертає токен

ReCaptcha captcha = new ReCaptcha();
captcha.setSiteKey("6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-");
captcha.setUrl("https://mysite.com/page/with/recaptcha");
captcha.setVersion("v3");
captcha.setAction("verify");
captcha.setScore(0.3);
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
funCaptcha

Метод вирішення FunCaptcha (Аркоселабс). Повертає токен для обходу капчі

FunCaptcha captcha = new FunCaptcha();
captcha.setSiteKey("69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC");
captcha.setUrl("https://mysite.com/page/with/funcaptcha");
captcha.setSUrl("https://client-api.arkoselabs.com");
captcha.setUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36");
captcha.setData("anyKey", "anyValue");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
geeTest

Метод вирішення капчі головоломки GeeTest. Повертає набір токенів у форматі JSON

GeeTest captcha = new GeeTest();
captcha.setGt("f2ae6cadcf7886856696502e1d55e00c");
captcha.setApiServer("api-na.geetest.com");
captcha.setChallenge("12345678abc90123d45678ef90123a456b");
captcha.setUrl("https://mysite.com/captcha.html");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
keyCaptcha

Метод вирішення KeyCaptcha на основі токенів

KeyCaptcha captcha = new KeyCaptcha();
captcha.setUserId(10);
captcha.setSessionId("493e52c37c10c2bcdf4a00cbc9ccd1e8");
captcha.setWebServerSign("9006dc725760858e4c0715b835472f22");
captcha.setWebServerSign2("2ca3abe86d90c6142d5571db98af6714");
captcha.setUrl("https://www.keycaptcha.ru/demo-magnetic/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
capy

Токен-оснований спосіб обходу капчі Capy puzzle

Capy captcha = new Capy();
captcha.setSiteKey("PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v");
captcha.setUrl("https://www.mysite.com/captcha/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
grid

Цей метод спочатку називався Old reCAPTCHA V2. Його можна використовувати для обходу будь-якого типу капчі, коли ви можете застосувати сітку до зображення і потрібно клацнути певні поля сітки. Повертає кількість осередків сітки

Grid captcha = new Grid();
captcha.setFile("path/to/captcha.jpg");
captcha.setRows(3);
captcha.setCols(3);
captcha.setPreviousId(0);
captcha.setCanSkip(false);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Select all images with an Orange");
canvas

Метод Canvas можна використовувати, коли потрібно намалювати лінію навколо об'єкта на зображенні. Повертає набір координат точок для малювання багатокутника.

Canvas captcha = new Canvas();
captcha.setFile("path/to/captcha.jpg");
captcha.setPreviousId(0);
captcha.setCanSkip(false);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Draw around apple");
clickCaptcha

Метод ClickCaptcha повертає координати точок на зображенні капчі. Може використовуватися, якщо потрібно клацнути певні точки на зображенні.

Coordinates captcha = new Coordinates();
captcha.setFile("path/to/captcha.jpg");
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Select all images with an Orange");
rotateCaptcha

Цей спосіб можна використовуватиме рішення капчі, яка просить повернути об'єкт. В основному використовується для обходу FunCaptcha. Повертає значення кута повороту.

Rotate captcha = new Rotate();
captcha.setFile("path/to/captcha.jpg");
captcha.setAngle(40);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Put the images in the correct way up");

Інші методи

Додаткові допустимі методи, що застосовуються в процесі роботи основних скриптів.

send / getResult

Цей метод можна використовувати для ручної передачі капчі та отримання відповідей.

String captchaId = solver.send(captcha);

Thread.sleep(20 * 1000);

String code = solver.getResult(captchaId);

balance

Використовуйте цей метод, щоб отримати баланс свого облікового запису.

double balance = solver.balance();

report

Використовуйте цей метод, щоб повідомити про правильне або неправильне рішення капчі.

solver.report(captcha.getId(), true); // captcha solved correctly
solver.report(captcha.getId(), false); // captcha solved incorrectly

Обробка помилок

Можливі варіанти стандартних помилок, що повертаються сервісом при обробці запитів

У разі помилки розв'язувач капчі видає виняток. Важливо правильно поводитися з цими випадками. Ми рекомендуємо використовувати try/catch для обробки винятків

try {
    solver.solve(captcha);
} catch (ValidationException e) {
    // invalid parameters passed
} catch (NetworkException e) {
    // network error occurred
} catch (ApiException e) {
    // api respond with error
} catch (TimeoutException e) {
    // captcha is not solved so far
}

Інші мови для інтеграції з API сервісу