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.
https://api.yescaptcha.com/reportEndpoint globalhttps://cn.yescaptcha.com/reportEndpoint ChinaParâmetros da requisição
Seção intitulada “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.
{ "id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"], "isSuccess": false}Resposta
Seção intitulada “Resposta”{ "errorId": 0, "status": "success"}Reporte de forma honesta
Seção intitulada “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: truepara tarefas reconhecidas corretamente efalsepara 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
Seção intitulada “Reembolso de pontos após reportar uma falha”- Apenas 5 tipos de reconhecimento de imagem têm reembolso de pontos:
FunCaptchaClassification,HCaptchaClassification,ReCaptchaV2Classification,AwsClassificationebCaptchaClassification. - 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.