getTaskResult – obter o resultado

getTaskResult consulta o resultado de uma tarefa assíncrona. Depois de criar a tarefa, chame-o a cada 5 segundos: se retornar processing, continue aguardando; se retornar ready, o resultado está em solution; se retornar um erro, pare. A consulta não cobra pontos, não importa quantas vezes você a faça.

POSThttps://api.yescaptcha.com/getTaskResultEndpoint globalCopiar

POSThttps://cn.yescaptcha.com/getTaskResultEndpoint ChinaCopiar

Parâmetros da requisição

Campo	Tipo	Obrigatório	Descrição
clientKey	string	Sim	Sua clientKey, a mesma usada na criação da tarefa
taskId	string	Sim	ID da tarefa retornado por createTask

{
  "clientKey": "YOUR_CLIENT_KEY",
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Resposta

Situação	Resposta	O que fazer
Em processamento	errorId igual a 0, status igual a processing	Consulte de novo em 5 segundos
Concluída	errorId igual a 0, status igual a ready, resultado em solution	Leia solution; os campos estão na página de cada tipo de tarefa
Falha no reconhecimento	errorId igual a 1, errorCode igual a ERROR_CAPTCHA_UNSOLVABLE	Pontos já reembolsados; você pode criar uma nova tarefa
Tempo esgotado	errorId igual a 1, errorCode igual a ERROR_TASK_TIMEOUT	Pontos já reembolsados; você pode criar uma nova tarefa
Tarefa inexistente ou expirada	errorId igual a 1, errorCode igual a ERROR_TASKID_INVALID	Pare de consultar este taskId

Exemplo de tarefa concluída (reCAPTCHA v2):

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU..."
  }
}

Regras

• Consulte a cada 5 segundos. Consultas repetidas do mesmo taskId dentro de 5 segundos retornam processing imediatamente; consultar com mais frequência não torna o resultado mais rápido.
• Uma tarefa leva no máximo cerca de 110 segundos (180 a 220 segundos em alguns tipos). Depois disso, retorna ERROR_TASK_TIMEOUT e os pontos são reembolsados automaticamente. Recomendamos definir o limite de espera no seu código em cerca de 3 minutos.
• O resultado fica guardado por cerca de 10 minutos; depois disso o taskId perde a validade e retorna ERROR_TASKID_INVALID. Use o resultado o quanto antes: o próprio token tem validade mais curta (cerca de 120 segundos no reCAPTCHA).
• Se houver erro, pare. Depois de errorId: 1, continuar consultando o mesmo taskId não muda o resultado; a partir da 3ª consulta de uma tarefa já encerrada, o final de errorDescription avisa para parar de consultar. ERROR_TASKID_INVALID conta nos erros da pausa automática (para o mesmo ID, só a primeira vez).
• Consulte no mesmo endpoint em que a tarefa foi criada.
• getTaskResult não é afetado pela pausa automática: tarefas criadas antes da pausa continuam podendo ser consultadas.