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.
- 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.
- Cada tarefa pode ser consultada dentro de 5 minutos após ser criada e será perdida após o tempo exceder.
- 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
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âmetros | Tipo | Obrigatório | Descrição |
---|---|---|---|
clientKey | string | Yes | Chave da conta do cliente, pode ser encontrada aqui |
taskId | string | Yes | ID criado pelo método createTask |
Exemplo de resposta
{
"errorId": 0,
"solution": {
"userAgent": "xxx",
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}
Estrutura da Resposta
Parâmetros | Tipo | Descrição |
---|---|---|
errorId | Integer | Mensagem de erro: 0 - sem erro 1 - com erro |
errorCode | String | Código de erro: lista completa de erros |
errorDescription | String | Descrição do erro |
status | String | • idle - Aguardando • processing - Em identificação • ready - A identificação está completa e o resultado está na chave “solution” |
solution | Object | Dados do resultado da tarefa. Diferente para cada tipo de tarefa |
Especificação de resposta
-
Reconhecimento bem-sucedido: Quando
errorId
é igual a0
estatus
é igual aready
, o resultado está emsolution
. -
Identificando: Quando
errorId
é igual a0
estatus
é igual aprocessing
, tente novamente em 3 segundos. -
Erro: Quando
errorId
é maior que0
, consulte as informações de erro de acordo comerrorDescription
.