TC Grid Captcha

ภาพรวม

TC Grid Captcha เป็นแคปต์ชา การเลือกกริด: หน้าเพจจะแสดง คำถาม/คำแนะนำ และกริดของกระเบื้อง ตัวแก้ต้องคืนค่าว่าเซลล์กริดใดที่ตรงกับคำถาม (ดัชนีฐาน 0, ลำดับแถว: ซ้ายไปขวา, บนลงล่าง)

คำถาม: 选择图像 是 "灰色花瓶"

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": "GridCaptcha",
    "subType": "tc",
    "image": "BASE64_GRID_IMAGE",
    "other": "灰色花瓶"
  }
}

การตอบกลับ

{
  "errorId": 0,
  "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

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": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

การตอบกลับ

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "click": "0,2,5"
  }
}

คำอธิบายสถานะ

• errorId = 0 และ status = ready: แก้ไขสำเร็จ อ่านดัชนีเซลล์ใน solution.click
• errorId = 0 และ status = processing: ยังประมวลผลอยู่ รอ 2 วินาทีแล้วตรวจสอบอีกครั้ง
• errorId > 0: ข้อผิดพลาดของระบบ ตรวจสอบ errorCode และ errorDescription

ตัวอย่างการผสานรวม

import requests
import base64
import time
 
def solve_tc(grid_path, question, api_key='YOUR_API_KEY'):
    with open(grid_path, 'rb') as f:
        grid_b64 = base64.b64encode(f.read()).decode()
 
    # ขั้นตอนที่ 1: สร้างงาน
    create_resp = requests.post(
        'https://api.achicaptcha.com/createTask',
        json={
            'clientKey': api_key,
            'task': {
                'type': 'GridCaptcha',
                'subType': 'tc',
                'image': grid_b64,
                'other': question
            }
        }
    )
    result = create_resp.json()
 
    if result['errorId'] != 0:
        raise Exception(result['errorDescription'])
 
    task_id = result['taskId']
 
    # ขั้นตอนที่ 2: ตรวจสอบผลลัพธ์
    while True:
        time.sleep(2)
        poll_resp = requests.post(
            'https://api.achicaptcha.com/getTaskResult',
            json={'clientKey': api_key, 'taskId': task_id}
        )
        result = poll_resp.json()
 
        if result['errorId'] != 0:
            raise Exception(result['errorDescription'])
 
        if result['status'] == 'ready':
            return result['solution']['click']  # e.g. "0,2,5"
 
# การใช้งาน
indices = solve_tc('grid.jpg', '灰色花瓶', 'YOUR_API_KEY')
print('เซลล์ที่ต้องคลิก:', indices)

รหัสข้อผิดพลาดทั่วไป

แนวปฏิบัติที่ดีที่สุด

1. การเข้ารหัสภาพ

• ส่งเฉพาะภาพ กริด เป็นสตริง Base64 เดียว
• อย่ารวมคำนำหน้า data:image/...;base64, — ใช้เฉพาะ Base64 ดิบ
• ตรวจสอบว่าภาพโหลดและเข้ารหัสเสร็จสมบูรณ์ก่อนส่ง

2. พารามิเตอร์ task.other

• ส่ง ข้อความคำถามที่แน่นอน ที่แสดงให้ผู้ใช้เห็น (เช่น "灰色花瓶")
• ฟิลด์นี้จำเป็น — การละเว้นจะทำให้ผลลัพธ์ไม่ถูกต้อง
• คัดลอกสตริงคำถามตามที่ปรากฏในความท้าทายแคปต์ชา

3. ช่วงเวลาการสำรวจ

• รอเวลาอย่างน้อย 2 วินาทีระหว่างการตรวจสอบผลลัพธ์
• อย่าส่งคำขอซ้ำๆ ไปยัง API
• ตั้งค่าเวลาหมดอายุเพื่อหลีกเลี่ยงลูปไม่สิ้นสุด (แนะนำ: 60 วินาที)

4. การประมวลผลผลลัพธ์

• solution.click คือสตริงดัชนีเซลล์ฐาน 0 (ลำดับแถว, ซ้ายไปขวา, บนลงล่าง) ที่คั่นด้วยเครื่องหมายจุลภาค
• แยกด้วย , และแปลงเป็นจำนวนเต็มก่อนคลิกเซลล์กริดที่สอดคล้องกัน

5. ตรรกะการลองใหม่

• ใช้การลองใหม่สำหรับข้อผิดพลาดชั่วคราวเช่น ERROR_NO_SLOT_AVAILABLE
• ใช้ exponential backoff เมื่อลองใหม่
• จำกัดจำนวนการลองใหม่สูงสุด

6. ความปลอดภัยของคีย์ API

• อย่าฮาร์ดโค้ดคีย์ API ในซอร์สโค้ด
• ใช้ตัวแปรสภาพแวดล้อมหรือตัวจัดการความลับ
• อย่าเปิดเผยคีย์ API ทางฝั่งไคลเอนต์

ลิงก์ที่เป็นประโยชน์:

• Achicaptcha Homepage (opens in a new tab)
• Introduction to Achicaptcha
• Install for Firefox (opens in a new tab)
• Install for Chrome (opens in a new tab)