Menu da documentação

reportIncorrectRecaptcha: send complaint on a Recaptcha token

São aceitas apenas reclamações para Recaptchas V2 e V3, incluindo o Enterprise Recaptcha. É importante ler a seguinte descrição, caso contrário, nosso sistema pode banir seus reports.

Devido à inabilidade de verificar seu report como fazemos com captchas de imagem, sua reclamação passa primeiro por análises de estatísticas em nosso backend, e é aprovada depois apenas no caso de uma resposta positiva. Basicamente, o que fazemos é comparar as estatísticas de seus reports com as estatísticas de outros clientes confiáveis. Se a taxa do seu report possui uma diferença muito grande de outros reports, ele será ignorado por um intervalo de vários dias. Assim, para melhores resultados, você deve sempre monitorar seus processos automáticos e enviar reports apenas quando você tiver 100% de certeza que o Recaptcha estava errado.

Nem todos os reports são aceitos. Para calcular a sua taxa média de falhas com o nível correto de precisão, um mínimo de 100 tarefas de recaptcha por conta deve ser enviado para o reconhecimento por 24 horas.

Reports devem ser enviados dentro de 60 segundos após a finalização da tarefa. Se você enviar o report mais tarde, a API vai retornar o erro ERROR_NO_SUCH_CAPTCHA_ID. É permitido enviar apenas um report por tarefa.

Endereço: https://api.anti-captcha.com/reportIncorrectRecaptcha
Método: POST
Content-type: application-json

Propriedades da solicitação

Propriedade Tipo Obrigatório Motivo
clientKey String Sim
taskId Inteiro Sim

Exemplo de solicitação

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "taskId":12345
}' https://api.anti-captcha.com/reportIncorrectRecaptcha
        


Estrutura da resposta

Propriedade Tipo Motivo
errorId Inteiro Identificador de erro.
0 - sem erros, a operação foi concluída com sucesso.
>1 - identificador de erro. Código de erro e curta descrição transferida nas propriedades errorCode e errorDescription.
errorCode String
errorDescription String Curta descrição do erro
status String
Resultado da operação. Você vai receber um código de erro ou status="success" quando a reclamação for aprovada.

Exemplo de resposta

JSON sem erros
          {
    "errorId":0,
    "status":"success"
}
        
JSON com um erro
          {
    "errorId": 16,
    "errorCode": "ERROR_NO_SUCH_CAPCHA_ID",
    "errorDescription": "Task you are requesting does not exist in your current task list or has been expired."
}