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.
Avvio rapidoInstallazione
Il pacchetto di script può essere installato manualmente o usando il programma di installazione del pacchetto
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
Opzione | Valore di default | Descrizione |
---|---|---|
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_timeout | 120 | Timeout 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_timeout | 600 | Timeout in secondi per i reCAPTCHA. Definisce per quanto tempo il modulo prova a ricevere una risposta dal terminale API res.php |
polling_interval | 10 | Intervallo in secondi tra le richieste al terminale API res.php . Impostare un valore minore a 5 secondi non è consigliato |
IMPORTANTE: una volta che ilcallback
viene creato per l'istanzaApi2Captcha
, 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
Opzione | valore di default | Descrizione |
---|---|---|
numeric | 0 | Definisce se il captcha contiene nnumeri o altri simboli a href='/2captcha-api#normal_post'>scopri di più sul documento API |
min_len | 0 | Lunghezza minima della risposta |
max_len | 0 | Lunghezza massima della risposta |
phrase | 0 | definisce se la risposta contiene più parole o no |
case_sensitive | 0 | definisce se la risposta distingue le maiuscole dalle minuscole |
calc | 0 | definisce 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 |
- Normal Captcha
- Text Captcha
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- KeyCaptcha
- Capy
- Grid
- Canvas
- ClickCaptcha
- Rotate
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'
})
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"
})
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'
})
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'
})
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"
})
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/'
})
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/'
})
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/'
})
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'
})
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'
})
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'
})
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
Pacchetto PHP per l'integrazione con il service API
Pacchetto Python per l'integrazione con il service API
Pacchetto Java per l'integrazione con il service API
Pacchetto C# per l'integrazione con il service API
Pacchetto Golang per l'integrazione con il service API
Pacchetto JavaScript per l'integrazione con il service API