Guia
getTaskResult: Resultado da Tarefa

getTaskResult: solicitar resultado da tarefa

Quando a tarefa iniciada por createTask for uma tarefa assíncrona, obtenha o resultado da tarefa assíncrona através de getTaskResult.

  1. O número máximo de requisições de consulta para cada tarefa é 120. Quando o número de requisições de consulta exceder, 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 do reconhecimento obtido por este método, dependendo da carga do sistema, você obterá o resultado em um intervalo de tempo de 1s a 30s.
AVISO

Observe que nem todas as tarefas precisam obter resultados desta forma. As duas tarefas a seguir precisam verificar os documentos.

  • Tarefas de classe Identify, ImageToText, etc, que são sincronizadas diretamente através dos resultados de retorno de createTask

Exemplo de requisição

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 Requisição

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

Exemplo de resposta

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

Estrutura da Resposta

ParâmetrosTipoDescrição
errorIdIntegerMensagem de erro:
0 - sem erro
1 - com erro
errorCodeStringerrorCode: lista completa de erros
errorDescriptionStringDescrição do Erro
statusString• idle - Aguardando
• processing - Em identificação
• ready - A identificação está completa e o resultado é encontrado no parâmetro solution
solutionObjectDados do resultado da tarefa. Diferente para cada tipo de tarefa

Especificação da resposta

  • Sucesso no reconhecimento: Quando errorId for igual a 0 e status for igual a ready , o resultado estará em solution.

  • Em identificação: Quando errorId for igual a 0 e status for igual a processing , por favor, tente novamente em 3 segundos.

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

    errorCode: lista completa de erros

createTask: Criar TarefagetToken: Obter Token Diretamente