CapMonster Cloud API

Reconnaissance Automatique de CAPTCHA via l'API CapMonster Cloud

La reconnaissance CAPTCHA via l'API CapMonster Cloud est un processus automatisé pour reconnaître et résoudre des mots ou symboles via des interfaces de programmation. Avec CapMonster Cloud, vous pouvez automatiser le contournement des CAPTCHA et accélérer votre flux de travail.

Comment Ça Marche

L'API résout les CAPTCHA selon le processus suivant :

1. Soumission de la Requête

Le client envoie une requête au serveur API avec les données CAPTCHA (image, clés du site, URL).

2. Traitement

Le serveur API traite la requête, reconnaît le CAPTCHA et commence à le résoudre.

3. Réception de la Solution

Le serveur API résout le CAPTCHA, permettant au client de continuer la vérification.

Pourquoi Utiliser une API pour Résoudre les CAPTCHA

Les API (interfaces de programmation d'applications) automatisent les actions sur les sites Web.

Remplir des formulaires d'inscription

Extraire et copier des données

Envoyer divers types d'informations à un serveur

Résolution Automatisée de CAPTCHA via API

L’API CapMonster Cloud utilise des requêtes HTTP standard avec des données au format JSON.

Adresses API

createTask
Crée une tâche de résolution de CAPTCHA.
javascript
JSON POST
```
https://api.capmonster.cloud/createTask
```
getTaskResult
Vérifie l’état de la tâche et récupère les résultats.
javascript
JSON POST
```
https://api.capmonster.cloud/getTaskResult
```
getBalance
Récupère le solde actuel du compte.
javascript
JSON POST
```
https://api.capmonster.cloud/getBalance
```
getUserAgent
Fournit les dernières données du navigateur et du système d’exploitation.
javascript
JSON POST
```
https://capmonster.cloud/api/useragent/actual
```

Algorithme de résolution de Captcha

Obtention de la clé

Tout d'abord, obtenez votre clé API unique dans le tableau de bord personnel de CapMonster Cloud.

Envoi d'une requête pour créer une tâche

Envoyez une requête HTTP POST à l'adresse :

javascript

https://api.capmonster.cloud/createTask

Incluez votre clé API et les détails de la tâche dans la requête.

Voici à quoi devrait ressembler votre requête :

json

{
  "clientKey":"API_KEY",
  "task": {
    "type":"RecaptchaV2TaskProxyless",
    "websiteURL":"https://example.com/",
    "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

Le serveur renverra l'identifiant du CAPTCHA (taskId) ou un code d'erreur si quelque chose ne va pas.

Obtention de la réponse

Après avoir créé la tâche, envoyez une requête pour obtenir la réponse à l'adresse :

javascript

https://api.capmonster.cloud/getTaskResult

Incluez votre clé API et l'identifiant de la tâche (taskId).

Voici à quoi devrait ressembler votre requête :

json

{
  "clientKey":"API_KEY",
  "taskId":12345678
}

Le serveur résoudra le captcha ou indiquera que la tâche est encore en cours.

Exemple de réponse :

json

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "gRecaptchaResponse":"response_token" 
  }
}

Gestion des erreurs : principaux types et instructions de dépannage

Erreurs principales que vous pourriez rencontrer :

INVALID KEY

Code d'erreur de l'API : ERROR_KEY_DOES_NOT_EXIST

Cette notification indique que la clé API saisie est incorrecte ou n'existe pas. Vérifiez si vous l'avez saisie correctement et réessayez.

NO FUNDS

Code d'erreur de l'API : ERROR_ZERO_BALANCE

Cette notification indique que vous n'avez pas suffisamment de fonds pour compléter la tâche (c'est-à-dire que le solde est nul). Rechargez votre compte pour continuer à résoudre.

BIG IMAGE SIZE

Code d'erreur de l'API : ERROR_TOO_BIG_CAPTCHA_FILESIZE

Cette notification indique que la taille du CAPTCHA dépasse la limite.

ZERO IMAGE SIZE

Code d'erreur de l'API : ERROR_ZERO_CAPTCHA_FILESIZE

Cette notification indique que la taille du CAPTCHA que vous téléchargez est inférieure à 100 octets.

CAPTCHA ID IS NOT FOUND

Code d'erreur de l'API : ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID

Le CAPTCHA n'a pas été trouvé dans le système (son ID n'a pas pu être localisé). Le statut du CAPTCHA doit être vérifié dans les 5 premières minutes après la soumission. Assurez-vous de vérifier dans ce délai.

CAPTCHA UNSOLVABLE

Code d'erreur de l'API : ERROR_CAPTCHA_UNSOLVABLE

Ce type de CAPTCHA n'est pas pris en charge par le service, ou l'image ne contient pas de réponse lisible, ce qui signifie qu'il s'agit de bruit. Elle pourrait être endommagée ou mal rendue.

CAPTCHA IS NOT READY

Code d'erreur de l'API : CAPTCHA_NOT_READY

Le CAPTCHA n'a pas encore été résolu. Attendez une minute ou deux.

REQUEST IS NOT ALLOWED FROM YOUR IP

Code d'erreur de l'API : ERROR_IP_NOT_ALLOWED

Cette notification indique que la requête depuis cette adresse IP a été rejetée. Ouvrez les paramètres de votre compte personnel et ajoutez votre IP à la liste des autorisés.

IP BANNED

Code d'erreur de l'API : ERROR_IP_BANNED

Vous avez dépassé la limite de requêtes avec une clé API incorrecte. Vérifiez la clé et essayez de créer la tâche à nouveau.

INCORRECT METHOD

Code d'erreur de l'API : ERROR_NO_SUCH_METHOD

Le type de CAPTCHA (valeur du paramètre "type") est incorrect. Vérifiez la correction de la méthode utilisée.

THE TOKEN IS EXPIRED

Code d'erreur de l'API : ERROR_TOKEN_EXPIRED

Lors de la reconnaissance du CAPTCHA, son fournisseur a remarqué que le jeton supplémentaire avait expiré. Créez une nouvelle tâche, obtenez un nouveau jeton et réessayez la requête.

NO FREE SERVERS

Code d'erreur de l'API : ERROR_NO_SLOT_AVAILABLE

Tous les serveurs sont occupés. Réessayez plus tard.