# getTaskResult – obter o resultado

> POST /getTaskResult consulta o resultado de uma tarefa assíncrona. Consulte a cada 5 segundos, continue aguardando em processing, leia solution em ready e pare se houver erro; a tarefa leva no máximo cerca de 110 segundos, o resultado fica guardado por cerca de 10 minutos e a consulta não cobra pontos.

Source: https://docs.yescaptcha.com/pt/api/get-task-result/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/api/get-task-result/

`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.

- POST `https://api.yescaptcha.com/getTaskResult` (Endpoint global)
- POST `https://cn.yescaptcha.com/getTaskResult` (Endpoint China)

## 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](https://docs.yescaptcha.com/pt/api/create-task.md) |

```json
{
  "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):

```json
{
  "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](https://docs.yescaptcha.com/pt/api/rate-limits.md) (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.