Resolvedor hCaptcha
Resolva desafios de imagem do hCaptcha enviando as imagens codificadas em base64 e o texto da pergunta. A API usa o tipo de tarefa PopularCaptchaImage, que suporta três modos de desafio.
Modos suportados
| Modo | questionType | Descrição | Resposta |
|---|---|---|---|
| Grade / Classificar | objectClassify | Selecione todas as imagens correspondentes em uma grade | boolean[] — uma por imagem |
| Clique | objectClick | Clique no centro de um objeto alvo | Coordenadas {x, y}[] |
| Arrastar e soltar | objectDrag | Arraste as peças do quebra-cabeça para a posição correta | Coordenadas {start, end}[] |
Criar tarefa — Grade / Classificar
O modo mais comum. Envie os blocos de imagem em base64 e o texto da pergunta.
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", "..."]
}
}
Resposta
{
"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 a imagem corresponde à pergunta.
Criar tarefa — Clique
Envie uma única imagem. O solver retorna as coordenadas do objeto alvo.
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClick",
"question": "Click on the center of the cat",
"queries": ["BASE64_MAIN_IMAGE"]
}
}
Resposta
{
"code": 200,
"answers": [[{ "x": 142, "y": 205 }]],
"questionType": "objectClick"
}
Criar tarefa — Arrastar e soltar
Envie a imagem de fundo em queries e a peça do quebra-cabeça em 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"]
}
}
Resposta
{
"code": 200,
"answers": [[{ "start": [100, 200], "end": [150, 250] }]],
"questionType": "objectDrag"
}
Parâmetros da tarefa
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
type | string | ✅ | PopularCaptchaImage ou PopularClassification |
questionType | string | ✅ | objectClassify, objectClick ou objectDrag |
question | string | ✅ | O texto da instrução do desafio |
queries | string[] | ✅ | Imagens codificadas em Base64 (blocos da grade ou imagem principal) |
examples | string[] | Somente arrastar | Objetos alvo para tarefas de arrastar |
screenshort | boolean | Não | Defina true se as imagens forem capturas de tela |
Playground da API
POST
Entrar para preencher automaticamente sua chave de API
Payload
Resposta
Clique em Enviar para ver a resposta
⌘ + Enter
Parâmetros
Códigos de erro
terminal