Skip to content
On this page
Home
>API
>createTask: Criar Tarefa

createTask: criação de tarefa

WARNING

Cria uma tarefa para resolver o tipo de captcha selecionado.

Especifique o tipo de captcha no parâmetro.

Por exemplo: ImageToTextTask

Você pode Ver todos os tipos de tarefas suportados

Exemplo de solicitação

json
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

{
    "clientKey": "YOUR_API_KEY",
    "appId": "APP_ID",
    "task": {
        "type": "ImageToTextTask", // Escreva abaixo o tipo que você precisa identificar
        "body": "Imagem BASE64"
    }
}

Parâmetros da solicitação

ParâmetrosTipoObrigatórioDescrição
clientKeyStringYesChave da conta do cliente, pode ser encontrada no painel
appIdStringNoSeu ID de desenvolvedor, solicitado na seção de desenvolvedor do painel
taskObjectYesObjeto de tarefa
callbackUrlStringNoO token será enviado (postado) para este endpoint

Exemplo de resposta

Exemplo de resposta de tarefa assíncrona

Quando uma tarefa é criada como uma tarefa de token ou uma tarefa assíncrona especial, o resultado da tarefa é obtido por meio do comando getTaskResult

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // Salve este ID para a próxima etapa
}

Exemplo de resposta de tarefa síncrona

Se o tipo de tarefa for reconhecimento de imagem, reconhecimento de voz ou algumas tarefas especiais, o resultado da tarefa é retornado diretamente. Pode ser verificado se o status é igual a ready

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "status": "ready",
    "solution": {
        "text": "44795sds"
    },
    "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b",
}

Estrutura da resposta

ParâmetrosTipoDescrição
errorIdIntegerMensagem de erro:
0 - sem erro
1 - com erro
errorCodeStringTabela de códigos de erro
errorDescriptionStringDescrição do erro
statusStringretorna o status, que pode ser nulo ou ready
solutionObjectA tarefa de sincronização retorna um resultado
taskIdStringID da tarefa criada, Obter resultados da tarefa