Решатель hCaptcha
Решайте задачи hCaptcha, отправляя изображения в base64 и текст задания. API использует тип задачи PopularCaptchaImage с тремя режимами.
Поддерживаемые режимы
| Режим | questionType | Описание | Ответ |
|---|---|---|---|
| Сетка / Классификация | objectClassify | Выбрать все подходящие изображения в сетке | boolean[] — по одному на изображение |
| Клик | objectClick | Кликнуть по центру целевого объекта | Координаты {x, y}[] |
| Drag & Drop | objectDrag | Перетащить фрагменты паззла на нужные места | Координаты {start, end}[] |
Создание задачи — Сетка / Классификация
Самый распространённый режим. Отправьте изображения сетки в base64 и текст задания.
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", "..."]
}
}
Ответ
{
"code": 200,
"msg": "",
"answers": [true, false, true, true, false, true, true, true, true],
"questionType": "objectClassify",
"meta": { "pass_report": true, "fail_report": true }
}
Каждый
answers[i]соответствуетqueries[i]—trueозначает совпадение с заданием.
Создание задачи — Клик
Отправьте одно изображение. Решатель вернёт координаты целевого объекта.
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClick",
"question": "Click on the center of the cat",
"queries": ["BASE64_MAIN_IMAGE"]
}
}
Ответ
{
"code": 200,
"answers": [[{ "x": 142, "y": 205 }]],
"questionType": "objectClick"
}
Создание задачи — Drag & Drop
Передайте фон в queries, а фрагмент паззла — в 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"]
}
}
Ответ
{
"code": 200,
"answers": [[{ "start": [100, 200], "end": [150, 250] }]],
"questionType": "objectDrag"
}
Параметры задачи
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
type | string | ✅ | PopularCaptchaImage или PopularClassification |
questionType | string | ✅ | objectClassify, objectClick или objectDrag |
question | string | ✅ | Текст инструкции задачи |
queries | string[] | ✅ | Изображения в base64 (сетка или основное изображение) |
examples | string[] | Только drag | Целевые объекты для drag-задач |
screenshort | boolean | Нет | true, если переданы скриншоты |
API Playground
POST
Log in to auto-fill your API key
Payload
Response
Hit Send to see response
⌘ + Enter
Parameters
Error Codes
terminal