# report — reportar resultados

> POST /report informa se os resultados das tarefas estavam corretos; reporte sucessos e falhas de forma honesta. Tarefas de reconhecimento de imagem reportadas como falha até 1 hora após a criação têm o reembolso de pontos liquidado após cerca de 24 horas.

Source: https://docs.yescaptcha.com/pt/api/report/ · 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/report/

`report` informa se o resultado de um grupo de tarefas estava correto. **Reporte tanto sucessos quanto falhas.** Quando um tipo de reconhecimento de imagem é reportado como errado, os pontos são reembolsados após cerca de 24 horas se os requisitos forem atendidos; os resultados reportados também são usados para avaliar e melhorar o reconhecimento.

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

## Parâmetros da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | array of string | Sim | Lista de IDs de tarefa; é possível reportar várias de uma vez |
| `isSuccess` | boolean | Sim | `true` se o reconhecimento estava correto, `false` se estava errado |

`clientKey` não é necessário: o ID da tarefa já identifica a tarefa.

```json
{
  "id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"],
  "isSuccess": false
}
```

## Resposta

```json
{
  "errorId": 0,
  "status": "success"
}
```

## Reporte de forma honesta

O reporte é usado tanto para liquidar o reembolso de pontos quanto para avaliar e melhorar o reconhecimento, por isso reporte o resultado real:

-   Reporte `isSuccess: true` para tarefas reconhecidas corretamente e `false` para as erradas. Reportes que só marcam falhas, ou que marcam tudo como falha independentemente do resultado, não são usados como referência nas estatísticas nem na liquidação.
-   A taxa de falha é calculada sobre todas as tarefas que você criou no período, não apenas sobre as que foram reportadas. Reportar mais falhas não gera mais reembolso: se a sua taxa de falha for claramente maior que a do mesmo período, o reembolso de pontos considera apenas a taxa de falha do período.
-   Quando uma verificação usa várias imagens (por exemplo, o FunCaptcha pede 5 rodadas) e você não sabe qual delas errou, pode reportar todo o grupo de tarefas como falha; quando a verificação for aprovada, reporte todo o grupo como sucesso da mesma forma.

## Reembolso de pontos após reportar uma falha

-   Apenas 5 tipos de reconhecimento de imagem têm reembolso de pontos: `FunCaptchaClassification`, `HCaptchaClassification`, `ReCaptchaV2Classification`, `AwsClassification` e `bCaptchaClassification`.
-   Só valem reportes feitos **em até 1 hora** após a criação da tarefa; cada tarefa é reembolsada apenas uma vez.
-   O reembolso não é imediato: é liquidado em lote **após cerca de 24 horas**.
-   Na liquidação, a taxa de falha reportada é comparada com a de outros usuários no mesmo período e para a mesma pergunta; se for claramente maior que a do período, o reembolso de pontos é feito com base na taxa de falha do período.
-   Em caso de dúvida sobre a liquidação, [entre em contato com o suporte](https://docs.yescaptcha.com/pt/help/contact.md) para contestar.

Nos tipos que retornam token (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha etc.), quem decide se o token é aprovado é o site de destino, portanto o reporte não gera reembolso de pontos. Resumo das regras de cobrança: [Cobrança e reembolso de pontos](https://docs.yescaptcha.com/pt/getting-started/billing.md).