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.
Démarrage rapideInstallation
Le paquet de scripts peut être installé à l'aide du programme d'installation des paquets ou manuellement.
Configuration
Description de tous les paramètres nécessaires pour configurer le paquet installé
Une instance de la classe Api2Captcha
peut être créée comme suit :
client = Api2Captcha.new('YOUR_API_KEY')
Vous avez également la possibilité de personnaliser certaines des options de l'instance créée :
client = Api2Captcha.new("YOUR_API_KEY")
client.api_key = "YOUR_API_KEY"
Options de l'instance Api2Captcha
Option | Valeur par défaut | Description |
---|---|---|
soft_id | - | votre ID de logiciel obtenu après publication dans 2Captcha le catalogue de logiciel |
callback | - | L'URL de votre web-sever qui reçoit le résultat de la reconnaissance du captcha. L'URL doit d'abord être enregistrée dans pingback settings de votre compte. |
default_timeout | 120 | Délai d'attente d'interrogation en secondes pour tous les types de captcha sauf reCAPTCHA. Définit la durée pendant laquelle le module essaie d'obtenir la réponse du point de terminaison de l'API res.php |
recaptcha_timeout | 600 | Délai d'interrogation pour reCAPTCHA en secondes. Définit combien de temps le module essaie d'obtenir la réponse du res.php endpoint API. |
polling_interval | 10 | Intervalle en secondes entre les requêtes au point de terminaison de l'API res.php , la définition de valeurs inférieures à 5 secondes n'est pas recommandée. |
IMPORTANT: une foisrappel
est défini pourApi2Captcha
l'instance, toutes les méthodes renvoient uniquement l'identifiant captcha et n'interrogent PAS l'API pour obtenir le résultat. Le résultat sera envoyé à l'URL de rappel. Pour obtenir la réponse manuellement, utilisez la méthode getResult
Résoudre le captcha
Lorsque vous soumettez un captcha basé sur une image, vous pouvez fournir des options supplémentaires pour aider les travailleurs de 2Captcha à le résoudre correctement.
Options de captcha
Option | Valeur par défaut | Description |
---|---|---|
numeric | 0 | Définit si le captcha contient des symboles numeric ou autres voir plus d'infos dans les docs de l'API. |
min_len | 0 | longueur minimale de réponse |
max_len | 0 | longueur maximale de la réponse |
phrase | 0 | définit si la réponse contient des mots multiples ou non |
case_sensitive | 0 | définit si la réponse est sensible à la casse |
calc | 0 | définit que le captcha nécessite un calcul |
lang | - | définit la langue du captcha, voir la liste des langues prises en charge. |
hint_image | - | une image avec un indice montré aux travailleurs avec le captcha |
hint_text | - | Indice ou texte de tâche montré aux travailleurs avec le captcha. |
- Normal Captcha
- Texte Captcha
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- KeyCaptcha
- Capy
- Grille
- Canvas
- ClickCaptcha
- Pivoter
Pour contourner un captcha normal (texte déformé sur l'image), utilisez la méthode suivante. Cette méthode peut également être utilisée pour reconnaître n'importe quel texte sur l'image.
result = client.normal({ image: 'path/to/captcha.jpg'})
# OR
result = client.normal({
image: 'https://site-with-captcha.com/path/to/captcha.jpg'
})
Cette méthode peut être utilisée pour contourner un captcha qui demande de répondre à une question fournie en clair.
result = client.text({
textcaptcha:'If tomorrow is Saturday, what day is today?',
lang: "en"
})
Utilisez cette méthode pour résoudre le reCAPTCHA V2 et obtenir un jeton pour contourner la protection.
result = client.recaptcha_v2({
googlekey: '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
pageurl: 'https://mysite.com/page/with/recaptcha_v2'
})
Cette méthode fournit la résolution reCAPTCHA V3 et retourne un jeton.
result = client.recaptcha_v3({
googlekey: '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
pageurl: 'https://mysite.com/page/with/recaptcha_v3',
version: 'v3',
score: 0.3,
action: 'verify'
})
Méthode de résolution de FunCaptcha (Arkoselabs). Retourne un jeton.
result = client.funcaptcha({
publickey: "69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC",
pageurl: "https://mysite.com/page/with/funcaptcha",
surl: "https://client-api.arkoselabs.com"
})
Méthode pour résoudre le puzzle captcha de GeeTest. Retourne un ensemble de jetons en JSON.
result = client.geetest({
gt: 'f1ab2cdefa3456789012345b6c78d90e',
api_server: 'api-na.geetest.com',
challenge: '12345678abc90123d45678ef90123a456b',
pageurl: 'https://www.site.com/page/'
})
Méthode basée sur les jetons pour résoudre 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/'
})
Méthode basée sur un jeton pour contourner le captcha du puzzle Capy.
result = client.capy({
sitekey: 'PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
pageurl: 'http://mysite.com/',
api_server: 'https://jp.api.capy.me/'
})
La méthode de la grille est initialement appelée méthode Old reCAPTCHA V2. Cette méthode peut être utilisée pour contourner tout type de captcha où vous pouvez appliquer une grille sur l'image et où vous devez cliquer sur des cases spécifiques de la grille. Retourne le nombre de cases.
La méthode Canvas peut être utilisée lorsque vous avez besoin de dessiner une ligne autour d'un objet sur une image. Renvoie un ensemble de coordonnées de points pour dessiner un polygone.
result = client.canvas({
image: 'path/to/captcha.jpg',
previous_id: 0,
lang: 'en',
hint_image: 'path/to/hint.jpg',
hint_text: 'Draw around apple'
})
La méthode ClickCaptcha renvoie les coordonnées des points sur l'image captcha. Peut être utilisée si vous avez besoin de cliquer sur des points particuliers de l'image.
result = client.coordinates({
image: 'path/to/captcha.jpg',
lang: 'en',
hint_image: 'path/to/hint.jpg',
hint_text: 'Connect the dots'
})
Cette méthode peut être utilisée pour résoudre un captcha qui demande de faire tourner un objet. Principalement utilisé pour contourner FunCaptcha. Retourne l'angle de rotation.
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'
})
Autres méthodes
Méthodes valides supplémentaires utilisées pendant le travail des scripts principaux
send / get_result
Ces méthodes peuvent être utilisées pour la soumission manuelle de captcha et le sondage des réponses.
# 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
Utilisez cette méthode pour obtenir le solde de votre compte.
balance = client.get_balance
report
Utilisez cette méthode pour signaler une bonne ou une mauvaise réponse au captcha.
client.report(captcha_id, True) # captcha solved correctly
client.report(captcha_id, False) # captcha solved incorrectly
Traitement des erreurs
Variantes possibles des erreurs standard renvoyées par le service lors du traitement des demandes
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
Autres langues pour l'intégration avec l'API de service
Paquet PHP pour l'intégration avec l'API de service
Paquet Python pour l'intégration avec l'API de service
Paquet Java pour l'intégration avec l'API de service
Paquet C# pour l'intégration avec l'API de service
Paquet Golang pour l'intégration avec l'API de service
Paquet JavaScript pour l'intégration avec l'API de service