Solucionador de hCaptcha
Resuelve los desafíos de imagen de hCaptcha enviando las imágenes en base64 y el texto de la pregunta. La API usa el tipo de tarea PopularCaptchaImage, que admite tres modos de desafío.
Modos admitidos
| Modo | questionType | Descripción | Respuesta |
|---|---|---|---|
| Cuadrícula / Clasificar | objectClassify | Selecciona todas las imágenes que coinciden en una cuadrícula | boolean[] — una por imagen |
| Clic | objectClick | Haz clic en el centro de un objeto objetivo | Coordenadas {x, y}[] |
| Arrastrar y soltar | objectDrag | Arrastra las piezas del puzle a su posición correcta | Coordenadas {start, end}[] |
Crear tarea — Cuadrícula / Clasificar
El modo más habitual. Envía las casillas de imagen en base64 y el texto de la pregunta.
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", "..."]
}
}
Respuesta
{
"code": 200,
"msg": "",
"answers": [true, false, true, true, false, true, true, true, true],
"questionType": "objectClassify",
"meta": { "pass_report": true, "fail_report": true }
}
Cada
answers[i]corresponde aqueries[i]:truesignifica que la imagen coincide con la pregunta.
Crear tarea — Clic
Envía una sola imagen. El solver devuelve las coordenadas del objeto objetivo.
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClick",
"question": "Click on the center of the cat",
"queries": ["BASE64_MAIN_IMAGE"]
}
}
Respuesta
{
"code": 200,
"answers": [[{ "x": 142, "y": 205 }]],
"questionType": "objectClick"
}
Crear tarea — Arrastrar y soltar
Envía la imagen de fondo en queries y la pieza del puzle en 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"]
}
}
Respuesta
{
"code": 200,
"answers": [[{ "start": [100, 200], "end": [150, 250] }]],
"questionType": "objectDrag"
}
Parámetros de la tarea
| Propiedad | Tipo | Obligatorio | Descripción |
|---|---|---|---|
type | string | ✅ | PopularCaptchaImage o PopularClassification |
questionType | string | ✅ | objectClassify, objectClick o objectDrag |
question | string | ✅ | Texto de la instrucción del desafío |
queries | string[] | ✅ | Imágenes codificadas en base64 (casillas de la cuadrícula o imagen principal) |
examples | string[] | Solo arrastrar | Objetos objetivo para las tareas de arrastre |
screenshort | boolean | No | Define true si las imágenes son capturas de pantalla |
Playground de la API
POST
Inicia sesión para rellenar automáticamente tu clave API
Payload
Respuesta
Pulsa Enviar para ver la respuesta
⌘ + Intro
Parámetros
Códigos de error
terminal