Skip to content
On this page
Home
>API
>getTaskResult: Resultado da Tarefa

getTaskResult: solicitar resultado da tarefa

Quando a tarefa iniciada pelo createTask é uma tarefa assíncrona, obtenha o resultado da tarefa assíncrona através do getTaskResult.

  1. O número máximo de solicitações de consulta para cada tarefa é 120. Quando o número de solicitações de consulta excede, os resultados da tarefa serão perdidos.
  2. Cada tarefa pode ser consultada dentro de 5 minutos após ser criada e será perdida após o tempo exceder.
  3. O resultado de reconhecimento obtido por este método, dependendo da carga do sistema, você obterá o resultado dentro de um intervalo de tempo de 1 segundo a 30 segundos.

WARNING

Observe que nem todas as tarefas precisam obter resultados desta maneira. As duas seguintes tarefas precisam verificar os documentos.

  • Tarefas de identificação de classe, como ImageToText, que são sincronizadas diretamente através do createTask retornam resultados

Exemplo de solicitação

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

{
    "clientKey":"YOUR_API_KEY",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" //ID criado pelo método createTask
}

Parâmetros da Solicitação

ParâmetrosTipoObrigatórioDescrição
clientKeystringYesChave da conta do cliente, pode ser encontrada aqui
taskIdstringYesID criado pelo método createTask

Exemplo de resposta

json
{
    "errorId": 0,
    "solution": {
        "userAgent": "xxx",
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
    },
    "status": "ready"
}

Estrutura da Resposta

ParâmetrosTipoDescrição
errorIdIntegerMensagem de erro:
0 - sem erro
1 - com erro
errorCodeStringCódigo de erro: lista completa de erros
errorDescriptionStringDescrição do erro
statusString• idle - Aguardando
• processing - Em identificação
• ready - A identificação está completa e o resultado está na chave "solution"
solutionObjectDados do resultado da tarefa. Diferente para cada tipo de tarefa

Especificação de resposta

  • Reconhecimento bem-sucedido: Quando errorId é igual a 0 e status é igual a ready, o resultado está em solution.

  • Identificando: Quando errorId é igual a 0 e status é igual a processing, tente novamente em 3 segundos.

  • Erro: Quando errorId é maior que 0, consulte as informações de erro de acordo com errorDescription.

    Código de erro: lista completa de erros