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.

Schnellstart

Installation

Das Skriptpaket kann mit dem Paketinstallationsprogramm oder manuell installiert werden

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.

Konfiguration

Beschreibung aller notwendigen Parameter zur Konfiguration des installierten Pakets

Eine Instanz der Klasse Api2Captcha kann wie folgt erstellt werden:

client = Api2Captcha.new('YOUR_API_KEY')

Sie haben auch die Möglichkeit, einige der Optionen für die erstellte Instanz anzupassen:

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

Optionen für die Api2Captcha-Instanz

Option	Standardwert	Beschreibung
soft_id	-	Ihre Software-ID, die Sie nach der Veröffentlichung im 2Captcha Softwarekatalog erhalten
callback	-	Die URL Ihres Web-Servers, der das Captcha-Erkennungsergebnis empfängt. Die URL sollte zuerst in den Pingback-Einstellungen Ihres Kontos registriert werden.
default_timeout	120	Abfragezeitlimit in Sekunden für alle Captcha-Typen außer reCAPTCHA. Definiert, wie lange das SDK versucht, die Antwort vom `res.php` API-Endpunkt zu erhalten.
recaptcha_timeout	600	Abfragezeitlimit in Sekunden für alle Captcha-Typen. Definiert, wie lange das SDK versucht, die Antwort vom `res.php` API-Endpunkt zu erhalten.
polling_interval	10	Intervall in Sekunden zwischen Anfragen an den `res.php` API-Endpunkt, Werte unter 5 Sekunden werden nicht empfohlen

WICHTIG: Sobald Callback für die Instanz Api2Captcha definiert ist, geben alle Methoden nur die Captcha-ID zurück und fragen NICHT die API ab, um das Ergebnis zu erhalten. Das Ergebnis wird an die Callback-URL gesendet. Um die Antwort manuell zu erhalten, verwenden Sie die getResult-Methode

Captcha lösen

Wenn Sie ein bildbasiertes Captcha einreichen, können Sie zusätzliche Optionen angeben, um 2Captcha Mitarbeitern zu helfen, es richtig zu lösen

Captcha-Optionen

Option	Standardwert	Beschreibung
numeric	0	Legt fest, ob Captcha numerische oder andere Symbole enthält Weitere Informationen in den API-Dokumenten
min_len	0	Minimale Länge der Antwort
max_len	0	maximale Länge der Antwort
phrase	0	definiert, ob die Antwort mehrere Wörter enthält oder nicht
case_sensitive	0	definiert, ob bei der Antwort Groß- und Kleinschreibung zu beachten ist
calc	0	definiert die Berechnung von Captcha
lang	-	definiert die Captcha-Sprache, siehe die Liste der unterstützten Sprachen
hint_image	-	ein Bild mit Hinweis, das den Mitarbeitern mit dem Captcha angezeigt wird
hint_text	-	Hinweis oder Aufgabentext, der den Mitarbeitern mit dem Captcha angezeigt wird

Um ein normales Captcha (verzerrter Text auf dem Bild) zu umgehen, verwenden Sie die folgende Methode. Diese Methode kann auch verwendet werden, um einen beliebigen Text auf dem Bild zu erkennen.

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

Diese Methode kann verwendet werden, um ein Captcha zu umgehen, das die Beantwortung einer Frage im Klartext verlangt.

result = client.text({
  textcaptcha:'If tomorrow is Saturday, what day is today?',
  lang: "en"
})

Verwenden Sie diese Methode, um reCAPTCHA V2 zu lösen und ein Token zur Umgehung des Schutzes zu erhalten.

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

Diese Methode stellt den reCAPTCHA V3-Löser bereit und gibt ein Token zurück.

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

FunCaptcha (Arkoselabs) Lösungsmethode. Gibt ein Token zurück.

Methode zum Lösen des GeeTest-Puzzle-Captcha. Gibt eine Reihe von Token als JSON zurück.

Token-basierte Methode zur Umgehung des Capy Puzzle-Captcha.

Die Grid-Methode wird ursprünglich als Old reCAPTCHA V2 Methode bezeichnet. Die Methode kann verwendet werden, um jede Art von Captcha zu umgehen, bei der Sie ein Gitter auf ein Bild anwenden können und bestimmte Gitterfelder anklicken müssen. Gibt die Anzahl der Felder zurück.

result = client.grid({
  image: 'path/to/captcha.jpg',
  rows: 3,
  cols: 3,
  previous_id: 0,
  lang: 'en',
  hint_image: 'path/to/hint.jpg',
  hint_text: 'Select all images with an Orange'
})

Die Methode Canvas kann verwendet werden, wenn Sie eine Linie um ein Objekt auf einem Bild zeichnen müssen. Gibt einen Satz von Punktkoordinaten zurück, um ein Polygon zu zeichnen.

Die ClickCaptcha-Methode gibt die Koordinaten von Punkten auf dem Captcha-Bild zurück. Kann verwendet werden, wenn Sie auf bestimmte Punkte des Bildes klicken müssen.

Diese Methode kann verwendet werden, um ein Captcha zu lösen, bei dem ein Objekt gedreht werden muss. Meistens verwendet, um FunCaptcha zu umgehen. Gibt den Rotationswinkel zurück.

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'
})

Sonstige Methoden

Zusätzliche gültige Methoden, die bei der Arbeit an den Hauptskripten verwendet werden

send / get_result

Diese Methoden können für die manuelle Captcha-Eingabe und die Abfrage von Antworten verwendet werden.

# 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

Verwenden Sie diese Methode, um das Guthaben Ihres Kontos abzurufen.

balance = client.get_balance

report

Verwenden Sie diese Methode, um positive oder negative Captcha-Antworten zu melden.

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

Fehlerbehandlung

Mögliche Varianten von Standardfehlern, die der Dienst bei der Bearbeitung von Anfragen zurückgibt

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

Installation

Bundler

Konfiguration

Captcha lösen

Sonstige Methoden

send / get_result

get_balance

report

Fehlerbehandlung

Andere Sprachen für die Integration mit der Dienst-API

PHP Paket für die Integration mit der Dienst-API

Python Paket für die Integration mit der Dienst-API

Java Paket für die Integration mit der Dienst-API

C# Paket für die Integration mit der Dienst-API

Golang Paket für die Integration mit der Dienst-API

JavaScript Paket für die Integration mit der Dienst-API