• Logo „PHP“
  • Logo „Python“
  • Logo „Java“
  • Logo „C#“
  • Logo „Ruby“
  • Logo „Golang“
  • Logo „JavaScript“
Bypass captcha in Ruby

Bypass captcha in Ruby
Logo „Ruby“
  • Logo „PHP“
  • Logo „Python“
  • Logo „Java“
  • Logo „C#“
  • Logo „Ruby“
  • Logo „Golang“
  • Logo „JavaScript“

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.

Avvio rapido

Installazione

Il pacchetto di script può essere installato manualmente o usando il programma di installazione del pacchetto

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.

Configurazione

Descrizione di tutti i parametri necessari per configurare il pacchetto installato

Un'istanza dell'ordine di Api2Captcha può essere creata in questo modo:

client = Api2Captcha.new('YOUR_API_KEY')

Hai anche la possibilità di personalizzare alcune delle opzioni per l'istanza:

client = Api2Captcha.new("YOUR_API_KEY")
client.api_key = "YOUR_API_KEY"
Opzioni per istanza Api2Captcha
OpzioneValore di defaultDescrizione
soft_id-l'ID del tuo software è stata ottenuta dopo aver pubblicato su 2Captcha software catalog
callback-L'URL del tuo server che riceve il risultato del riconoscimento captcha. L'URL dovrebbe venire registrato sul tuo account nella sezione impostazioni pingback
default_timeout120Timeout in secondi per tutti i tipi di captcha eccetto i reCAPTCHA. Definisce per quanto tempo il modulo prova a ricevere una risposta dal terminale API res.php
recaptcha_timeout600Timeout in secondi per i reCAPTCHA. Definisce per quanto tempo il modulo prova a ricevere una risposta dal terminale API res.php
polling_interval10Intervallo in secondi tra le richieste al terminale API res.php. Impostare un valore minore a 5 secondi non è consigliato
IMPORTANTE: una volta che il callback viene creato per l'istanza Api2Captcha, tutti i metodi rimandano solo l'ID del captcha e NON interpellano l'API per avere il risultato. I risultati verranno mandati all'URL del callback. Per ricere le risposte manualmente usare getResult method

Risolvere i captcha

Quando invii qualsiasi captcha con un'immagine, puoi fornire opzioni aggiuntive per aiutare gli operatori di 2Captcha a risolverlo correttamente

Opzioni captcha
Opzionevalore di defaultDescrizione
numeric0Definisce se il captcha contiene nnumeri o altri simboli a href='/2captcha-api#normal_post'>scopri di più sul documento API
min_len0Lunghezza minima della risposta
max_len0Lunghezza massima della risposta
phrase0definisce se la risposta contiene più parole o no
case_sensitive0definisce se la risposta distingue le maiuscole dalle minuscole
calc0definisce se il captcha necessita di un calcolo
lang-definisce il linguaggio del captcha, guarda la lista dei linguaggi supportati
hint_image-un'immagine con il suggerimento mostrata agli operatori con il captcha
hint_text-suggerimento o testo mostrato agli operatori con il captcha
simpleCaptcha

Per bypassare un normal captcha (testo distorto in un'immagine) usa il metodo seguente. QUesta modalità può venire utilizzata anche per riconoscere il testo nell'immagine

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

Questo metodo può essere usato per bypassare un captcha che richiede di rispondere ad una domanda di testo.

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

Usa questo metodo per risolvere i reCAPTCHA V2 e ottenere il token per bypassare la protezione.

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

Questo metodo permette di risolvere il reCAPTCHA V3 e ricevere il token.

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

Metodo per risolvere FunCaptcha (Arkoselabs). In cambio viene dato un token.

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

Metodo per risolvere un captcha puzzle GeeTest. In cambio viene dato un set di token come JSON.

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

Metodo basato su token per risolvere i KeyCaptcha.

result = client.keycaptcha({
  s_s_c_user_id: 10,
  s_s_c_session_id: '493e52c37c10c2bcdf4a00cbc9ccd1e8',
  s_s_c_web_server_sign: '9006dc725760858e4c0715b835472f22-pz-',
  s_s_c_web_server_sign2: '2ca3abe86d90c6142d5571db98af6714',
  pageurl: 'https://www.keycaptcha.ru/demo-magnetic/'
})
capy

Metodo basato su token per bypassare i captcha Capy Puzzle.

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

Il metodo Grid era in origine chiamato il metodo per i vecchi reCAPTCHA V2. Può essere usato per bypassare qualsiasi tipo di captcha nel quale bisogna applicare una griglia ad un'immagine e cliccare su specifiche sezioni di essa. In cambio vengono dati i numeri delle sezioni.

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

Il metodo canvas può essere usato quando bisogna disegnare una linea intorno ad un oggetto o un'immagine. Riporta un set di coordinate di punti per disegnare un poligono.

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

Il metodo clickCaptcha riporta le coordinate di alcuni punti sull'immagine del captcha. Può essere usato se c'è bisogno di cliccaresu un particolare punto dell'immagine.

result = client.coordinates({
  image: 'path/to/captcha.jpg',
  lang: 'en',
  hint_image: 'path/to/hint.jpg',
  hint_text: 'Connect the dots'
})
rotateCaptcha

Questo metodo può essere usato per risolvere un captcha che richiede di girare un oggetto. Viene usato principalmente per ricolvere i FunCaptcha. Riporta l'angolo di rotazione.

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

Altre modalità

Ulteriori metodi validi usati durante il lavoro degli script principali

send / get_result

Queste modalità possono essere utilizzate per inserire il captcha manualmente e rispondere ai sondaggi.

# 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

Usa questa modalità per accedere al saldo del tuo conto.

balance = client.get_balance

report

Usa questa modalità per segnalare una risposta captcha giusta o sbagliata.

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

Gestione degli errori

Possibili varianti di errori standard sperimentato dal servizio mentre processa le richieste

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

Altri linguaggi per l'integrazione con il servizio API