Omitir captcha en JAVA

Omitir captcha en JAVA

Implementa la biblioteca Java para omitir la verificación rápida de captcha. API simple para resolver captcha.

Paquete Java para una fácil integración con la API del servicio de resolución de captcha de 2Captcha para omitir reCAPTCHA, hCaptcha, Arkose captcha, geetest y resuelve cualquier otro captchas

Inicio rápido

Instalación

El paquete de secuencias de comandos se puede instalar usando el instalador de paquetes o manualmente

Repositorio central de Maven

El artefacto 2captcha-java está disponible en Maven Central

Te invitamos a explorar nuestro repositorio GitHub donde puedes encontrar bibliotecas y módulos para fácil integración con nuestra API.

Configuración

Descripción de todos los parámetros necesarios para configurar el paquete instalado

Una instancia de la clase TwoCaptcha se puede crear así:

TwoCaptcha solver = new TwoCaptcha('YOUR_API_KEY');

También tiene la posibilidad de personalizar algunas de las opciones para la instancia creada:

solver.setSoftId(123);
solver.setCallback("https://your.site/result-receiver");
solver.setDefaultTimeout(120);
solver.setRecaptchaTimeout(600);
solver.setPollingInterval(10);
Opciones de instancia de TwoCaptcha
OpciónValor por defectoDescripción
softId-su ID de software obtenido después de publicarlo en el 2Captcha catálogo de software
llamar de vuelta-URL de su servidor web que recibe el resultado del reconocimiento de captcha. La URL debe registrarse primero en configuración de pingback de su cuenta
tiempo de espera predeterminado120Tiempo de espera de sondeo en segundos para todos los tipos de captcha excepto reCAPTCHA. Define cuánto tiempo el módulo intenta obtener la respuesta desde el extremo de la API res.php
recaptchaTiempo de espera600Tiempo de espera de sondeo para reCAPTCHA en segundos. Define cuánto tiempo el módulo intenta obtener la respuesta desde el extremo de la API res.php
intervalo de votación10Intervalo en segundos entre las solicitudes al punto final de la API res.php; no se recomienda establecer valores inferiores a 5 segundos
IMPORTANTE: una vez que devolución de llamada se define para la instancia de TwoCaptcha, todos los métodos devuelven solo el ID de captcha y DO NO sondee la API para obtener el resultado. El resultado se enviará a la URL de devolución de llamada. Para obtener la respuesta manualmente, use el método getResult

Resolver Captcha

Cuando envía cualquier captcha basado en imágenes, el uso puede proporcionar opciones adicionales para ayudar a los trabajadores de 2Captcha a resolverlo correctamente

Opciones de captcha
opciónValor por defectoDescripción
numeric0Define si el captcha contiene símbolos numéricos u otros ver más información en los documentos API
minLength0longitud mínima de respuesta
maxLength0longitud máxima de respuesta
phrase0define si la respuesta contiene varias palabras o no
caseSensitive0define si la respuesta es sensible a mayúsculas y minúsculas
calc0define captcha requiere cálculo
lang-define el idioma captcha, consulte la lista de idiomas admitidos
hintImg-Una imagen con pista mostrada a los trabajadores con el captcha.
hintText-sugerencia o texto de tarea que se muestra a los trabajadores con el captcha

Ejemplo básico

El siguiente ejemplo muestra un ejemplo de llamada de solucionador básico con manejo de errores.

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

Para omitir un captcha normal (texto distorsionado en la imagen), use el siguiente método. Este método también se puede utilizar para reconocer cualquier texto en la imagen.

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");
textoCaptcha

Este método se puede usar para omitir un captcha que requiere responder una pregunta proporcionada en texto claro.

recaptchaV2

Utilice este método para resolver reCAPTCHA V2 y obtener un token para eludir la protección.

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

Este método proporciona el solucionador reCAPTCHA V3 y devuelve un token.

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

Método de resolución FunCaptcha (Arkoselabs). Devuelve una ficha.

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

Método para resolver el captcha del rompecabezas GeeTest. Devuelve un conjunto de tokens como 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");
hCaptcha

Utilice este método para resolver el desafío hCaptcha. Devuelve un token para omitir el captcha.

HCaptcha captcha = new HCaptcha();
captcha.setSiteKey("10000000-ffff-ffff-ffff-000000000001");
captcha.setUrl("https://www.site.com/page/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");
claveCaptcha

Método basado en token para resolver KeyCaptcha.

capy

Método basado en tokens para eludir el captcha del rompecabezas de Capy.

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

El método de cuadrícula se llama originalmente método Old reCAPTCHA V2. El método se puede usar para omitir cualquier tipo de captcha donde puede aplicar una cuadrícula en la imagen y necesita hacer clic en cuadros de cuadrícula específicos. Devuelve números de cajas.

canvas

El método de lienzo se puede usar cuando necesita dibujar una línea alrededor de un objeto en la imagen. Devuelve un conjunto de coordenadas de puntos para dibujar un polígono.

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");
clicCaptcha

El método ClickCaptcha devuelve las coordenadas de los puntos en la imagen captcha. Se puede usar si necesita hacer clic en puntos particulares de la imagen.

rotateCaptcha

Este método se puede usar para resolver un captcha que pide rotar un objeto. Se utiliza principalmente para eludir FunCaptcha. Devuelve el ángulo de rotación.

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");

Otros metodos

Métodos válidos adicionales utilizados durante el trabajo de los guiones principales

send / getResult

Estos métodos se pueden utilizar para el envío manual de captchas y encuestas de respuesta.

String captchaId = solver.send(captcha);

Thread.sleep(20 * 1000);

String code = solver.getResult(captchaId);

balance

Utilice este método para obtener el saldo de su cuenta.

double balance = solver.balance();

report

Use este método para informar una respuesta de captcha buena o mala.

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

Manejo de errores

Posibles variantes de errores estándar devueltos por el servicio al procesar solicitudes

Si se produce un error, el solucionador de captcha arroja una excepción. Es importante manejar adecuadamente estos casos. Recomendamos usar try/catch para manejar las excepciones.

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
}

Otros idiomas para la integración con la API del servicio