Shopee Captcha

Aperçu

Shopee Captcha est un système de captcha utilisé par Shopee pour protéger les utilisateurs et les systèmes contre les comportements anormaux tels que les bots, le spam ou la connexion automatisée.

Achicaptcha prend en charge la résolution automatique des captchas Shopee pour diverses plateformes (navigateur, émulateur, téléphone). Consultez le guide ci-dessous pour intégrer l'API.

1. Créer une Tâche

Requête

POST https://api.achicaptcha.com/createTask

Paramètres

Exemple de Requête

POST /createTask HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "VOTRE_CLE_API",
  "task": {
    "type": "ShopeeCaptchaTask",
    "image": "/9j/4AAQSkZJRgABAQEASABIAAD...|/9j/4DSJFHKSDJDS...",
    "subType": 0
  }
}

Réponse

{
  "errorId": 0,
  "taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

2. Obtenir le Résultat

Requête

POST https://api.achicaptcha.com/getTaskResult

Paramètres

Exemple de Requête

POST /getTaskResult HTTP/1.1
Host: api.achicaptcha.com
Content-Type: application/json
 
{
  "clientKey": "Votre API_KEY",
  "taskId": "f2fc70d6-c76b-4fba-9480-205ac1fe9fb9"
}

Réponse

{
  "errorId": 0,
  "status": "ready",
  "solution": "x1,y1,x2,y2"
}

Signification de la Réponse

• errorId = 0 et status = ready : Résolu avec succès, lire le résultat dans solution
• errorId = 1 et status = processing : Le captcha est en cours de résolution, attendez 1-2 secondes et réessayez
• errorId autre que 0 et 1 : Erreur système, code d'erreur et description fournis
• solution : Pour captcha curseur : retourne la coordonnée de l'axe x à faire glisser

Exemples d'Intégration

import requests
import time
 
def solve_shopee_captcha(mask_image, bg_image, sub_type, api_key='VOTRE_CLE_API'):
    # Étape 1 : Créer une tâche
    create_task_url = 'https://api.achicaptcha.com/createTask'
    create_task_payload = {
        'clientKey': api_key,
        'task': {
            'type': 'ShopeeCaptchaTask',
            'image': mask_image + '|' + bg_image,
            'subType': sub_type
        }
    }
    
    response = requests.post(create_task_url, json=create_task_payload)
    result = response.json()
    
    if result['errorId'] != 0:
        raise Exception(result['errorDescription'])
    
    task_id = result['taskId']
    
    # Étape 2 : Obtenir le résultat
    get_result_url = 'https://api.achicaptcha.com/getTaskResult'
    
    while True:
        time.sleep(2)  # Attendre 2 secondes
        
        get_result_payload = {
            'clientKey': api_key,
            'taskId': task_id
        }
        
        response = requests.post(get_result_url, json=get_result_payload)
        result = response.json()
        
        if result['errorId'] == 0 and result['status'] == 'ready':
            return result['solution']
        
        if result['errorId'] != 0 and result['errorId'] != 1:
            raise Exception(result['errorDescription'])
        
        # Si status == 'processing', continuer la boucle
 
# Utilisation
mask_image = '/9j/4AAQSkZJRgABAQEASABIAAD...'  # Image masque Base64
bg_image = '/9j/4DSJFHKSDJDS...'  # Image arrière-plan Base64
sub_type = 0  # 0: Captcha curseur
solution = solve_shopee_captcha(mask_image, bg_image, sub_type, 'VOTRE_CLE_API')
print('Solution du captcha Shopee:', solution)

Codes d'Erreur Courants

Codes d'Erreur lors de la Création de Tâche

Codes d'Erreur lors de l'Obtention du Résultat

Meilleures Pratiques

1. Préparer les Images Base64

• Convertir les images masque et arrière-plan au format Base64
• Assurez-vous que la qualité de l'image est claire pour augmenter la précision
• Connectez deux images avec le caractère | (pipe)

2. Intervalle de Polling

• Attendez au moins 1-2 secondes entre les vérifications de résultat
• Ne spammez pas l'API avec trop de requêtes consécutives
• Ayez un timeout pour éviter les boucles infinies (recommandé 120 secondes)

3. Gestion des Erreurs

• Vérifiez errorId pour détecter les erreurs
• errorId = 0 et status = ready : Succès
• errorId = 1 : En traitement, continuer le polling
• errorId autre que 0 et 1 : Erreur système, nécessite une gestion

4. Logique de Réessai

• Implémentez un réessai pour les erreurs temporaires
• Utilisez un backoff exponentiel lors du réessai
• Limitez le nombre maximum de tentatives de réessai

5. Sécurité de la Clé API

• Ne codez pas en dur la clé API dans le code
• Utilisez des variables d'environnement
• N'exposez pas la clé API côté client

Liens Utiles :

• Page d'accueil Achicaptcha (opens in a new tab)
• Introduction à Achicaptcha
• Installer pour Firefox (opens in a new tab)
• Installer pour Chrome (opens in a new tab)