SDK Python NextCaptcha Solver : installation, configuration et utilisation

Python est un langage de programmation interprété de haut niveau. Il est reconnu pour sa simplicité et sa lisibilité. Polyvalent, il peut être utilisé pour le développement web, l'analyse de données, l'intelligence artificielle, et bien plus encore.

Intégrez notre package de résolution de captcha Python pour résoudre automatiquement le CAPTCHA sur n'importe quel site Web.

Intégration facile avec l'API du service de résolution de captcha pour contourner reCAPTCHA et résoudre tout autre CAPTCHA

Installation

Installer le SDK Python NextCaptcha avec pip ou manuellement

PIP

Pour installer le SDK Python NextCaptcha, vous pouvez utiliser pip (recommandé) ou l'installer manuellement.

1. Installer avec pip (recommandé)#

Si le SDK NextCaptcha est publié sur PyPI, vous pouvez l'installer avec :

pip install nextcaptcha-python

Ou, s'il est hébergé sur GitHub :

pip install git+https://github.com/nextcaptcha/nextcaptcha-python.git

2. Installation manuelle#

Si vous disposez du SDK sous forme de fichier local ou d’archive ZIP, suivez ces étapes :

Step 1: Télécharger le SDK#

Cloner le dépôt :

git clone https://github.com/nextcaptcha/nextcaptcha-python.git
cd nextcaptcha-python

Téléchargez le ZIP depuis GitHub, extrayez-le et accédez au dossier.

Installer localement.#

pip install .

Ou, si le SDK n'est pas structuré comme un package :

python setup.py install

Vérifier l'installation#

Exécutez Python et vérifiez si le package s'importe correctement :

import nextcaptcha
print(nextcaptcha.__version__)

Si vous rencontrez des problèmes, assurez-vous que les dépendances requises sont installées avec :

pip install -r requirements.txt

Configuration

Configurer le SDK Python NextCaptcha avec les paramètres nécessaires

Configuration du SDK Solver

Pour configurer le SDK Python NextCaptcha, vous devrez configurer les paramètres suivants :

client_key: Votre clé API de NextCaptcha
soft_id: Votre identifiant de logiciel (facultatif)
callback_url: L'URL pour recevoir les réponses de manière asynchrone (si vous utilisez le mode de rappel)
open_log: Activer la journalisation pour le débogage

Exemple de configuration#

Voici comment vous pouvez configurer et utiliser le SDK Python NextCaptcha :

from nextcaptcha import NextCaptchaAPI
 
# Configuration settings
config = {
    "client_key": "your_client_key_here",  # Replace with your NextCaptcha API key
    "soft_id": 12345,  # Your software ID (optional, replace if required)
    "callback_url": "https://your-callback-url.com",  # Callback URL (optional)
    "open_log": True  # Enable logging for debugging
}
 
# Initialize the NextCaptcha client
solver = NextCaptchaAPI(**config)
 
# Test request (example: solving a reCAPTCHA)
task = {
    "type": "ReCaptchaV2TaskProxyless",
    "websiteURL": "https://example.com",
    "websiteKey": "your_recaptcha_site_key"
}
 
# Send the task and get the result
try:
    task_id = solver.create_task(task)
    result = solver.get_result(task_id)
    print("Captcha solution:", result)
except Exception as e:
    print("Error:", str(e))

Explication des paramètres#

Paramètre	Description
`client_key`	Votre clé API NextCaptcha (obligatoire)
`soft_id`	Votre identifiant de logiciel (facultatif)
`callback_url`	Une URL où les résultats seront envoyés (facultatif, uniquement pour les tâches asynchrones)
`open_log`	Si « True », active la journalisation pour le débogage

notes#

Si vous utilisez le mode de rappel, la solution sera envoyée à `callback_url`, vous n'avez donc pas besoin de récupérer les résultats manuellement.
Si `open_log=True`, les journaux seront imprimés pour aider au débogage.
Assurez-vous de remplacer les espaces réservés (`your_client_key_here`, etc.) par vos informations d'identification réelles.

Résoudre le CAPTCHA

Résoudre reCAPTCHA v2/v3/Enterprise via une méthode basée sur des jetons

Pour résoudre reCAPTCHA v2, v3, Enterprise ou la version mobile à l'aide de la méthode basée sur les jetons de NextCaptcha, suivez ces étapes :

1. Résoudre le reCAPTCHA via une méthode basée sur des jetons#

Utilisez l'approche basée sur les jetons pour obtenir le jeton « g-recaptcha-response ».

Résoudre reCAPTCHA v2 avec la méthode basée sur le jeton#

 
# {props.t('solve6')}
 
result = api.recaptchav2(website_url="https://example.com", website_key="SITE_KEY")

Résoudre reCAPTCHA v2 Enterprise avec la méthode basée sur les jetons#

# {props.t('solve6')}
result = api.recaptchav2enterprise(website_url="https://example.com", website_key="SITE_KEY")

Résolvez reCAPTCHA v2 Enterprise avec une méthode basée sur un jeton à score élevé#

result = api.recaptchav2hs_enterprise(website_url="https://example.com", website_key="SITE_KEY")

Résolvez reCAPTCHA v3 ou v3 Enterprise avec la méthode basée sur un jeton#

result = api.recaptchav3(website_url="https://example.com", website_key="SITE_KEY")

Résolvez reCAPTCHA v3 ou v3 Enterprise avec une méthode basée sur un jeton à score élevé#

result = api.recaptchav3hs(website_url="https://example.com", website_key="SITE_KEY")

Résoudre reCAPTCHA Mobile avec la méthode basée sur les jetons#

result = api.recaptcha_mobile(app_key="APP_KEY", app_package_name="com.example.app", app_action="APP_ACTION", app_device="ios")

3. Utiliser le jeton#

Après avoir reçu le jeton « g-recaptcha-response », injectez-le dans le formulaire du site Web et soumettez-le.

<input type="hidden" name="g-recaptcha-response" value="your_token_here" />

Explication des paramètres#

Paramètre	Description
`website_url`	L'URL du site Web où se trouve le reCAPTCHA
`website_key`	La clé du site du reCAPTCHA
`page_action`	Le paramètre d'action à utiliser pour le reCAPTCHA
`api_domain`	Le domaine de l'API reCAPTCHA si différent de celui par défaut
`website_info`	Configuration reCAPTCHA détaillée sur un site Web cible

Notes clés#

✅ Soutient reCAPTCHA v2, v3, Entreprise et Mobile

✅ Proxyless le mode est disponible (utilisez un proxy si le site nécessite des IP spécifiques)

✅ Token-based la méthode permet de contourner le captcha de manière transparente.

Autres méthodes

Pour vérifier le solde de votre compte NextCaptcha, utilisez la méthode suivante :

Exemple d'obtention d'équilibre#

# Get account balance
balance = api.get_balance()
print(f"Account balance: {balance}")

Notes clés#

✅ Récupère votre solde disponible en USD.

✅ Assurez-vous que votre clé API est valide pour obtenir le solde correct.

Gestion des erreurs

Si une erreur survient lors de la résolution d'un captcha, le SDK renvoie un dictionnaire contenant les informations d'erreur. Vous pouvez vérifier le champ d'état pour déterminer si la requête a réussi. Si le statut est « prêt », le captcha a été résolu avec succès et la solution est fournie dans le champ de solution. Si le statut est « échec », le champ d'erreur contient une description de l'erreur.

Identifiant	Code	Description
0	-	aucune erreur ne s'est produite
1	`ERROR_KEY_DOES_NOT_EXIST`	Votre clé API est incorrecte. Veuillez vous assurer de l'avoir configurée correctement et copiez-la depuis le mode client ou développeur dans le Panneau de configuration.
10	`ERROR_ZERO_BALANCE`	Le solde de votre compte est nul
11	`ERROR_IP_NOT_ALLOWED`	La demande a été effectuée à partir d'une adresse IP qui ne figure pas dans votre liste d'adresses IP de confiance
12	`ERROR_CAPTCHA_UNSOLVABLE`	Le captcha ne peut pas être résolu normalement. Il peut rencontrer un proxy ou la solution échoue pour diverses raisons liées au réseau. En général, vous pouvez réessayer.
14	`ERROR_NO_SUCH_METHOD`	Une méthode qui n'existe pas dans l'API a été demandée
15	`ERROR_IMAGE_TYPE_NOT_SUPPORTED`	L'image ne peut pas être traitée car le format ou la taille de l'image est incorrect ou l'image est corrompue. Veuillez vérifier l'image dans votre demande
16	`ERROR_NO_SUCH_CAPCHA_ID`	L'identifiant Captcha que vous avez fourni est incorrect
21	`ERROR_IP_BLOCKED`	Votre adresse IP a été bannie en raison d'une utilisation inappropriée de l'API
22	`ERROR_TASK_ABSENT`	Vous n'avez pas inclus l'attribut de tâche dans l'appel de méthode createTask
23	`ERROR_TASK_NOT_SUPPORTED`	L'attribut de tâche dans votre appel de méthode createTask contient un type de tâche qui n'est pas pris en charge par notre API, ou l'attribut de type est incorrect.
31	`ERROR_RECAPTCHA_INVALID_SITEKEY`	La valeur reCAPTCHA sitekey que vous avez fournie n'est pas valide.
55	`ERROR_ACCOUNT_SUSPENDED`	Votre compte a été suspendu en raison d'une utilisation inappropriée de l'API. Veuillez vous connecter via l'équipe d'assistance Telegram pour résoudre ce problème.
130	`ERROR_BAD_PROXY`	Les paramètres du proxy sont incorrects ou la connexion ne peut pas être établie via le proxy
110	`ERROR_BAD_PARAMETERS`	Un paramètre captcha requis est manquant dans votre demande ou le format du paramètre est incorrect. Veuillez vous assurer que le format de charge utile de votre demande est approprié pour le type de tâche sélectionné.
500	`ERROR_UNKNOWN`	Erreur inconnue. Il peut s'agir d'une erreur inattendue dans le système. Vous pouvez contacter l'administrateur qui a envoyé l'erreur pour résoudre le problème.

Installation

PIP

1. Installer avec pip (recommandé)#

2. Installation manuelle#

Step 1: Télécharger le SDK#

Installer localement.#

Vérifier l'installation#

Configuration

Configuration du SDK Solver

** Exemple de configuration**#

Explication des paramètres#

notes#

Résoudre le CAPTCHA

1. Résoudre le reCAPTCHA via une méthode basée sur des jetons#

Résoudre reCAPTCHA v2 avec la méthode basée sur le jeton#

Résoudre reCAPTCHA v2 Enterprise avec la méthode basée sur les jetons#

Résolvez reCAPTCHA v2 Enterprise avec une méthode basée sur un jeton à score élevé#

Résolvez reCAPTCHA v3 ou v3 Enterprise avec la méthode basée sur un jeton#

Résolvez reCAPTCHA v3 ou v3 Enterprise avec une méthode basée sur un jeton à score élevé#

Résoudre reCAPTCHA Mobile avec la méthode basée sur les jetons#

3. Utiliser le jeton#

Explication des paramètres#

Notes clés#

Autres méthodes

Exemple d'obtention d'équilibre#

Notes clés#

Gestion des erreurs

Exemple de configuration#