Bộ giải HCaptcha
Giải thử thách hình ảnh hCaptcha bằng cách cung cấp các ảnh mã hóa base64 và nội dung câu hỏi. API dùng loại tác vụ PopularCaptchaImage, hỗ trợ ba chế độ thử thách.
Các chế độ được hỗ trợ
| Chế độ | questionType | Mô tả | Phản hồi |
|---|---|---|---|
| Lưới / Phân loại | objectClassify | Chọn tất cả ảnh khớp trong lưới | boolean[] — một giá trị cho mỗi ảnh |
| Nhấp | objectClick | Nhấp vào tâm của đối tượng cần tìm | Tọa độ {x, y}[] |
| Kéo & thả | objectDrag | Kéo mảnh ghép đến đúng vị trí | Tọa độ {start, end}[] |
Tạo tác vụ — Lưới / Phân loại
Chế độ phổ biến nhất. Gửi các ô ảnh mã hóa base64 và nội dung câu hỏi.
POST
/createTaskHostapi.captchasonic.com
Content-Typeapplication/json
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClassify",
"question": "Select all images with a bus",
"queries": ["BASE64_IMG_1", "BASE64_IMG_2", "..."]
}
}
Phản hồi
{
"code": 200,
"msg": "",
"answers": [true, false, true, true, false, true, true, true, true],
"questionType": "objectClassify",
"meta": { "pass_report": true, "fail_report": true }
}
Mỗi
answers[i]tương ứng vớiqueries[i]—truenghĩa là ảnh khớp với câu hỏi.
Tạo tác vụ — Nhấp
Gửi một ảnh. Bộ giải trả về tọa độ của đối tượng cần tìm.
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClick",
"question": "Click on the center of the cat",
"queries": ["BASE64_MAIN_IMAGE"]
}
}
Phản hồi
{
"code": 200,
"answers": [[{ "x": 142, "y": 205 }]],
"questionType": "objectClick"
}
Tạo tác vụ — Kéo & thả
Gửi ảnh nền trong queries và mảnh ghép trong examples.
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectDrag",
"question": "Drag the puzzle piece to the gap",
"queries": ["BASE64_BACKGROUND"],
"examples": ["BASE64_PUZZLE_PIECE"]
}
}
Phản hồi
{
"code": 200,
"answers": [[{ "start": [100, 200], "end": [150, 250] }]],
"questionType": "objectDrag"
}
Tham số tác vụ
| Thuộc tính | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
type | string | ✅ | PopularCaptchaImage hoặc PopularClassification |
questionType | string | ✅ | objectClassify, objectClick hoặc objectDrag |
question | string | ✅ | Nội dung hướng dẫn thử thách |
queries | string[] | ✅ | Ảnh mã hóa base64 (các ô lưới hoặc ảnh chính) |
examples | string[] | Chỉ với kéo | Đối tượng đích cho tác vụ kéo |
screenshort | boolean | Không | Đặt true nếu ảnh là ảnh chụp màn hình |
Sân chơi API
POST
Đăng nhập để tự động điền API key của bạn
Payload
Phản hồi
Nhấn Gửi để xem phản hồi
⌘ + Enter
Tham số
Mã lỗi
terminal