POST/createTask
{
"clientKey": "YOUR_API_KEY",
"appId": "app_0123456789",
"task": {
"type": "ImageToTextTask",
"body": "BASE64_IMAGE"
}
}| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
clientKey |
string | sim | Chave de API no corpo |
appId |
string | não | AppID de desenvolvedor: app_ seguido de 10 caracteres hexadecimais. Espaços no início e no fim são removidos; a comparação não diferencia maiúsculas de minúsculas. |
task |
object | sim | Parâmetros da tarefa |
task.type |
string | sim | Nome do tipo, com distinção entre maiúsculas e minúsculas |
callbackUrl |
string | não | Apenas URL HTTP(S) pública. Entrega pelo menos uma vez; elimine duplicatas com Idempotency-Key ou X-Captcha-Callback-Id, cujo valor é o ID da tarefa (taskId). |
Você também pode enviar o AppID no cabeçalho X-App-Id. O appId na raiz do corpo tem prioridade, mesmo quando seu valor é inválido.
AppIDs com formato inválido, inexistentes, pendentes de análise, rejeitados ou desativados, com mais de 64 caracteres ou cujo desenvolvedor teve a participação na receita suspensa são ignorados sem erro. A criação de tarefas e a cobrança funcionam da mesma forma com ou sem AppID. Ao migrar do CapSolver, você pode manter o appId existente na requisição; ele será ignorado se não corresponder a um aplicativo Kaptra ativo.
status pode ser processing, ready ou failure.