Shopee Captcha

Tổng quan

Shopee Captcha là hệ thống captcha được Shopee sử dụng để bảo vệ người dùng và hệ thống khỏi hành vi bất thường như bot, spam, hoặc đăng nhập tự động.

Achicaptcha hỗ trợ giải tự động captcha Shopee cho nhiều nền tảng khác nhau (trình duyệt, giả lập, điện thoại). Xem hướng dẫn bên dưới để tích hợp API.

🛍️

Đối với captcha chữ của Shopee, vui lòng tham khảo Text Captcha. Nếu có vấn đề phát sinh, vui lòng liên hệ admin (opens in a new tab) để được hỗ trợ.

1. Tạo yêu cầu

Request

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

Tham số

Tên param	Kiểu dữ liệu	Bắt buộc?	Mô tả
`clientKey`	string	yes	Api key
`task.type`	string	yes	ShopeeCaptchaTask
`task.image`	string	yes	Base64 ảnh mask\|Base64 ảnh background
`task.subType`	int	yes	Loại captcha: 0: Slider captcha

Ví dụ Request

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
  }
}

Response

Khi thành công, server sẽ trả về errorId = 0 và taskId

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

2. Lấy kết quả

Request

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

Tham số

Tên param	Kiểu dữ liệu	Bắt buộc?	Mô tả
`clientKey`	string	yes	Api key, liên hệ admin
`taskId`	string	yes	TaskId lấy từ (1)

Ví dụ Request

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

Response

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

Ý nghĩa kết quả trả về

errorId = 0 và status = ready: Giải thành công, đọc kết quả trong solution
errorId = 1 và status = processing: Đang giải captcha, đợi 1-2 giây rồi thử lại
errorId khác 0 và 1: Lỗi hệ thống, đưa ra mã lỗi và mô tả lỗi
solution: Với captcha kéo: trả về toạ độ cần kéo theo trục x của ảnh

Ví dụ tích hợp

import requests
import time
 
def solve_shopee_captcha(mask_image, bg_image, sub_type, api_key='YOUR_API_KEY'):
    # Bước 1: Tạo 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']
    
    # Bước 2: Lấy kết quả
    get_result_url = 'https://api.achicaptcha.com/getTaskResult'
    
    while True:
        time.sleep(2)  # Đợi 2 giây
        
        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'])
        
        # Nếu status == 'processing', tiếp tục loop
 
# Sử dụng
mask_image = '/9j/4AAQSkZJRgABAQEASABIAAD...'  # Base64 ảnh mask
bg_image = '/9j/4DSJFHKSDJDS...'  # Base64 ảnh background
sub_type = 0  # 0: Slider captcha
solution = solve_shopee_captcha(mask_image, bg_image, sub_type, 'YOUR_API_KEY')
print('Shopee captcha solution:', solution)

Các mã lỗi thường gặp

Mã lỗi khi tạo task

Mã lỗi	Mô tả	Chú thích
0	success	Tạo task thành công
2	missing required fields	Thiếu trường bắt buộc, kiểm tra lại tham số (image, subType)
3	task not supported	Loại task không được hỗ trợ
4	task creation failed	Tạo task thất bại, thử lại sau
5	client key does not exist	API key không tồn tại, kiểm tra lại API key
6	insufficient account balance	Số dư tài khoản không đủ, nạp thêm credit

Mã lỗi khi lấy kết quả

Mã lỗi	Mô tả	Chú thích
0	success	Thành công, đọc kết quả trong trường `solution`
1	processing	Đang xử lý, đợi 1-2 giây rồi gửi request lại
5	client key does not exist	API key không tồn tại, kiểm tra lại API key
7	task failed, please create a new task	Task thất bại, vui lòng tạo task mới
8	task ID does not exist	Task ID không tồn tại hoặc đã hết hạn

Best Practices

Để đạt hiệu quả tốt nhất khi sử dụng API Achicaptcha cho Shopee Captcha, hãy tuân thủ các nguyên tắc sau:

1. Chuẩn bị ảnh Base64

Chuyển đổi ảnh mask và background sang định dạng Base64
Đảm bảo chất lượng ảnh rõ ràng để tăng độ chính xác
Kết nối hai ảnh bằng ký tự | (pipe)

2. Polling interval

Đợi ít nhất 1-2 giây giữa các lần kiểm tra kết quả
Không spam API với quá nhiều request liên tiếp
Có timeout để tránh vòng lặp vô hạn (khuyến nghị 120 giây)

3. Xử lý lỗi

Kiểm tra errorId để phát hiện lỗi
errorId = 0 và status = ready: Thành công
errorId = 1: Đang xử lý, tiếp tục polling
errorId khác 0 và 1: Lỗi hệ thống, cần xử lý

4. Retry logic

Implement retry cho các lỗi tạm thời
Sử dụng exponential backoff khi retry
Giới hạn số lần retry tối đa

5. Bảo mật API key

Không hardcode API key trong code
Sử dụng biến môi trường
Không expose API key ra client-side

Liên kết hữu ích:

Tiktok Captcha Faucet Captcha