Captcha de Shopee

Descripción General

El Captcha de Shopee es un sistema de captcha utilizado por Shopee para proteger a los usuarios y sistemas de comportamientos anormales como bots, spam o inicio de sesión automatizado.

Achicaptcha admite la resolución automática de captcha de Shopee para varias plataformas (navegador, emulador, teléfono). Consulta la guía a continuación para integrar la API.

1. Crear Tarea

Solicitud

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

Parámetros

Ejemplo de Solicitud

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

Respuesta

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

2. Obtener Resultado

Solicitud

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

Parámetros

Ejemplo de Solicitud

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

Respuesta

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

Significado de la Respuesta

• errorId = 0 y status = ready: Resuelto exitosamente, lee el resultado en solution
• errorId = 1 y status = processing: El captcha se está resolviendo, espera 1-2 segundos e intenta de nuevo
• errorId distinto de 0 y 1: Error del sistema, se proporciona código de error y descripción
• solution: Para captcha deslizante: devuelve la coordenada del eje x para arrastrar

Ejemplos de Integración

import requests
import time
 
def solve_shopee_captcha(mask_image, bg_image, sub_type, api_key='TU_CLAVE_API'):
    # Paso 1: Crear tarea
    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']
    
    # Paso 2: Obtener resultado
    get_result_url = 'https://api.achicaptcha.com/getTaskResult'
    
    while True:
        time.sleep(2)  # Esperar 2 segundos
        
        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', continuar el bucle
 
# Uso
mask_image = '/9j/4AAQSkZJRgABAQEASABIAAD...'  # Imagen de máscara en Base64
bg_image = '/9j/4DSJFHKSDJDS...'  # Imagen de fondo en Base64
sub_type = 0  # 0: Captcha deslizante
solution = solve_shopee_captcha(mask_image, bg_image, sub_type, 'TU_CLAVE_API')
print('Solución del captcha de Shopee:', solution)

Códigos de Error Comunes

Códigos de Error al Crear Tarea

Códigos de Error al Obtener Resultado

Mejores Prácticas

1. Preparar Imágenes Base64

• Convierte las imágenes de máscara y fondo al formato Base64
• Asegúrate de que la calidad de la imagen sea clara para aumentar la precisión
• Conecta las dos imágenes con el carácter | (pipe)

2. Intervalo de Sondeo

• Espera al menos 1-2 segundos entre verificaciones de resultado
• No envíes spam a la API con demasiadas solicitudes consecutivas
• Ten un tiempo de espera para evitar bucles infinitos (recomendado 120 segundos)

3. Manejo de Errores

• Verifica errorId para detectar errores
• errorId = 0 y status = ready: Éxito
• errorId = 1: Procesando, continuar el sondeo
• errorId distinto de 0 y 1: Error del sistema, necesita manejo

4. Lógica de Reintento

• Implementa reintento para errores temporales
• Usa retroceso exponencial al reintentar
• Limita los intentos máximos de reintento

5. Seguridad de la Clave API

• No codifiques la clave API en el código
• Usa variables de entorno
• No expongas la clave API en el lado del cliente

Enlaces Útiles:

• Página Principal de Achicaptcha (opens in a new tab)
• Introducción a Achicaptcha
• Instalar para Firefox (opens in a new tab)
• Instalar para Chrome (opens in a new tab)