Bypass captcha in Ruby

Ruby gem for easy integration with the API of captcha solving service to bypass reCAPTCHA, Arkose captcha, Geetest and solve any other captchas. This is the easiest way to quickly integrate 2Captcha solving service into code and automate solving of any type of captcha.

Inicio rápido

Instalación

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

Bundler

To install a gem, you can use the bundler package manager. Download it from the link and install according to the instructions.

# Gemfile
gem 'ruby-2captcha'

We invite you to explore our GitHub repository where you can find ruby API client for easy integration with our API.

Configuración

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

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

client = Api2Captcha.new('YOUR_API_KEY')

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

client = Api2Captcha.new("YOUR_API_KEY")
client.api_key = "YOUR_API_KEY"

Opciones de instancia de Api2Captcha

Opción	Valor por defecto	Descripción
soft_id	-	su ID de software obtenido después de publicarlo en el 2Captcha catálogo de software
callback	-	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
default_timeout	120	Tiempo 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`
recaptcha_timeout	600	Tiempo 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`
polling_interval	10	Intervalo 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 Api2Captcha, 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ón	Valor por defecto	Descripción
numeric	0	Define si el captcha contiene símbolos numéricos u otros ver más información en los documentos API
min_len	0	longitud mínima de respuesta
max_len	0	longitud máxima de respuesta
phrase	0	define si la respuesta contiene varias palabras o no
case_sensitive	0	define si la respuesta es sensible a mayúsculas y minúsculas
calc	0	define captcha requiere cálculo
lang	-	define el idioma captcha, consulte la lista de idiomas admitidos
hint_image	-	Una imagen con pista mostrada a los trabajadores con el captcha.
hint_text	-	sugerencia o texto de tarea que se muestra a los trabajadores con el captcha

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.

result = client.normal({ image: 'path/to/captcha.jpg'})
# OR
result = client.normal({
  image: 'https://site-with-captcha.com/path/to/captcha.jpg'
})

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

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

result = client.recaptcha_v2({
  googlekey: '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
  pageurl: 'https://mysite.com/page/with/recaptcha_v2'
})

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

result = client.recaptcha_v3({
  googlekey: '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
  pageurl: 'https://mysite.com/page/with/recaptcha_v3',
  version: 'v3',
  score: 0.3,
  action: 'verify'
})

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

result = client.funcaptcha({
  publickey: "69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC",
  pageurl: "https://mysite.com/page/with/funcaptcha",
  surl: "https://client-api.arkoselabs.com"
})

Método para resolver el captcha del rompecabezas GeeTest. Devuelve un conjunto de tokens como JSON.

result = client.geetest({
  gt: 'f1ab2cdefa3456789012345b6c78d90e',
  api_server: 'api-na.geetest.com',
  challenge: '12345678abc90123d45678ef90123a456b',
  pageurl: 'https://www.site.com/page/'
})

Método basado en token para resolver KeyCaptcha.

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

result = client.capy({
  sitekey: 'PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
  pageurl: 'http://mysite.com/',
  api_server: 'https://jp.api.capy.me/'
})

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.

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.

result = client.canvas({
  image: 'path/to/captcha.jpg',
  previous_id: 0,
  lang: 'en',
  hint_image: 'path/to/hint.jpg',
  hint_text: 'Draw around apple'
})

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.

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.

result = client.rotate({
  image: 'path/to/captcha.jpg',
  angle: 40,
  lang: 'en',
  hint_image: 'path/to/hint.jpg',
  hint_text: 'Put the images in the correct way'
})

Otros metodos

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

send / get_result

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

# example for normal captcha
captcha_id = client.send('path/to/captcha.jpg')

# or for another captcha, for example for lemin
captcha_id = client.send({
  method:"lemin",
  captcha_id: "CROPPED_3dfdd5c_d1872b526b794d83ba3b365eb15a200b",
  api_server: "api.leminnow.com",
  div_id: "lemin-cropped-captcha",
  pageurl: "https://www.site.com/page/"
})

time.sleep(20)

# Get result
result = client.get_result(captcha_id)

get_balance

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

balance = client.get_balance

report

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

client.report(captcha_id, True) # captcha solved correctly
client.report(captcha_id, False) # captcha solved incorrectly

Manejo de errores

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

If case of an error captcha solver throws an exception. It's important to properly handle these cases. We recommend to use begin/rescue to handle exceptions.

begin
result = client.text('If tomorrow is Saturday, what day is today?')
rescue Api2Captcha::ValidationException => e
  # invalid parameters passed
  puts(e)
rescue Api2Captcha::NetworkException => e
  # network error occurred
  puts(e)
rescue Api2Captcha::ApiException => e
  # api respond with error
  puts(e)
rescue Api2Captcha::TimeoutException => e
  # captcha is not solved so far
  puts(e)
end

Bypass captcha in Ruby

Instalación

Bundler

Configuración

Resolver Captcha

Otros metodos

send / get_result

get_balance

report

Manejo de errores

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

Paquete PHP para la integración con la API del servicio

Paquete Python para la integración con la API del servicio

Paquete Java para la integración con la API del servicio

Paquete C# para la integración con la API del servicio

Paquete Golang para la integración con la API del servicio

Paquete JavaScript para la integración con la API del servicio