Pular para o conteúdo
StatusPainel

Referência da API

report — reportar resultados

Esta página foi traduzida automaticamente da versão em chinês e pode conter erros. Prevalece a versão em chinês.

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.

POSThttps://api.yescaptcha.com/reportEndpoint global
POSThttps://cn.yescaptcha.com/reportEndpoint China
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.

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

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