Shopee Captcha

Обзор

Shopee Captcha — это система капчи, используемая Shopee для защиты пользователей и систем от аномального поведения, такого как боты, спам или автоматический вход.

Achicaptcha поддерживает автоматическое решение капчи Shopee для различных платформ (браузер, эмулятор, телефон). См. руководство ниже для интеграции API.

1. Создание задачи

Запрос

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

Параметры

Пример запроса

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

Ответ

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

2. Получение результата

Запрос

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

Параметры

Пример запроса

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

Ответ

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

Значение ответа

• errorId = 0 и status = ready: Успешно решено, читайте результат в solution
• errorId = 1 и status = processing: Капча решается, подождите 1-2 секунды и попробуйте снова
• errorId отличный от 0 и 1: Системная ошибка, предоставлен код ошибки и описание
• solution: Для капчи-слайдера: возвращает координату по оси X для перетаскивания

Примеры интеграции

import requests
import time
 
def solve_shopee_captcha(mask_image, bg_image, sub_type, api_key='YOUR_API_KEY'):
    # Step 1: Create task
    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']
    
    # Step 2: Get result
    get_result_url = 'https://api.achicaptcha.com/getTaskResult'
    
    while True:
        time.sleep(2)  # Wait 2 seconds
        
        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'])
        
        # If status == 'processing', continue loop
 
# Usage
mask_image = '/9j/4AAQSkZJRgABAQEASABIAAD...'  # Base64 mask image
bg_image = '/9j/4DSJFHKSDJDS...'  # Base64 background image
sub_type = 0  # 0: Slider captcha
solution = solve_shopee_captcha(mask_image, bg_image, sub_type, 'YOUR_API_KEY')
print('Shopee captcha solution:', solution)

Коды общих ошибок

Коды ошибок при создании задачи

Коды ошибок при получении результата

Лучшие практики

1. Подготовьте изображения Base64

• Конвертируйте изображения маски и фона в формат Base64
• Убедитесь, что качество изображения четкое для повышения точности
• Соедините два изображения символом | (труба)

2. Интервал опроса

• Ждите не менее 1-2 секунд между проверками результата
• Не отправляйте слишком много последовательных запросов к API
• Установите тайм-аут, чтобы избежать бесконечных циклов (рекомендуется 120 секунд)

3. Обработка ошибок

• Проверяйте errorId для обнаружения ошибок
• errorId = 0 и status = ready: Успех
• errorId = 1: В обработке, продолжайте опрос
• errorId отличный от 0 и 1: Системная ошибка, требует обработки

4. Логика повторных попыток

• Реализуйте повторные попытки для временных ошибок
• Используйте экспоненциальную задержку при повторных попытках
• Ограничьте максимальное количество попыток

5. Безопасность API ключа

• Не прописывайте API ключ жестко в коде
• Используйте переменные окружения
• Не раскрывайте API ключ на стороне клиента

Полезные ссылки:

• Домашняя страница Achicaptcha (opens in a new tab)
• Введение в Achicaptcha
• Установить для Firefox (opens in a new tab)
• Установить для Chrome (opens in a new tab)