Shopee Captcha

Visão Geral

O Shopee Captcha é um sistema de captcha usado pela Shopee para proteger usuários e sistemas de comportamentos anormais, como bots, spam ou login automatizado.

O Achicaptcha suporta a resolução automática de captcha da Shopee para várias plataformas (navegador, emulador, telefone). Veja o guia abaixo para integrar a API.

1. Criar Tarefa

Solicitação

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

Parâmetros

Exemplo de Solicitação

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

Resposta

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

2. Obter Resultado

Solicitação

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

Parâmetros

Exemplo de Solicitação

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

Resposta

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

Significado da Resposta

• errorId = 0 e status = ready: Resolvido com sucesso, leia o resultado em solution
• errorId = 1 e status = processing: O captcha está sendo resolvido, aguarde 1-2 segundos e tente novamente
• errorId diferente de 0 e 1: Erro do sistema, código de erro e descrição fornecidos
• solution: Para captcha deslizante: retorna a coordenada do eixo x para arrastar

Exemplos de Integração

import requests
import time
 
 
def solve_shopee_captcha(mask_image, bg_image, sub_type, api_key='SUA_CHAVE_API'):
    # Passo 1: Criar tarefa
    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']
    
    # Passo 2: Obter resultado
    get_result_url = 'https://api.achicaptcha.com/getTaskResult'
    
    while True:
        time.sleep(2)  # Aguardar 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'])
        
        # Se status == 'processing', continuar loop
 
# Uso
mask_image = '/9j/4AAQSkZJRgABAQEASABIAAD...'  # Imagem de máscara Base64
bg_image = '/9j/4DSJFHKSDJDS...'  # Imagem de fundo Base64
sub_type = 0  # 0: Captcha deslizante
solution = solve_shopee_captcha(mask_image, bg_image, sub_type, 'SUA_CHAVE_API')
print('Solução do captcha Shopee:', solution)

Códigos de Erro Comuns

Códigos de Erro ao Criar Tarefa

Códigos de Erro ao Obter Resultado

Melhores Práticas

1. Preparar Imagens Base64

• Converta imagens de máscara e de fundo para o formato Base64
• Garanta que a qualidade da imagem seja nítida para aumentar a precisão
• Conecte as duas imagens com o caractere | (pipe)

2. Intervalo de Polling

• Aguarde pelo menos 1-2 segundos entre as verificações de resultado
• Não envie spam para a API com muitas solicitações consecutivas
• Tenha um tempo limite (timeout) para evitar loops infinitos (recomendado 120 segundos)

3. Tratamento de Erros

• Verifique errorId para detectar erros
• errorId = 0 e status = ready: Sucesso
• errorId = 1: Processando, continue o polling
• errorId diferente de 0 e 1: Erro do sistema, precisa de tratamento

4. Lógica de Tentativa (Retry)

• Implemente tentativas para erros temporários
• Use backoff exponencial ao tentar novamente
• Limite o número máximo de tentativas

5. Segurança da Chave API

• Não codifique a chave da API diretamente no código
• Use variáveis de ambiente
• Não exponha a chave da API no lado do cliente (client-side)

Links Úteis:

• Página Inicial do Achicaptcha (opens in a new tab)
• Introdução ao Achicaptcha
• Instalar para Firefox (opens in a new tab)
• Instalar para Chrome (opens in a new tab)