Menu da documentação

reportCorrectRecaptcha: report correctly solved Recaptcha tokens

Use esse método junto com o reportIncorrectRecaptcha para suas tarefas de Recaptcha V3 e Recaptcha V2 Enterprise. Reports para o Recaptcha V2 são aceitos atualmente, mas eventualmente ignorados. Nossa qualidade para o V2 é aproximadamente 99% e você não precisa construir uma whitelist de workers bem sucedidos.

Por trás, nós colocaremos o worker que você reportou em uma whitelist, e na próxima rodada de indicação de workers para os seus captchas, nosso sistema vai basear-se nessa lista para os seus captchas. Se algum dos workers reportados estiver online e ocioso, ele ou ela será colocado na frente da fila para pegar uma nova tarefa. O sistema vai manter esse registro pela próxima hora e pode removê-lo se você enviar uma requisição de reportIncorrectRecaptcha para uma tarefa, que é executada pelo mesmo worker da whitelist.
De forma resumida, reportCorrectRecaptcha adiciona workers à sua whitelist, reportIncorrectRecaptcha faz a remoção dos mesmos.

Reportar tokens resolvidos de forma correta vai funcionar em volumes significativos, começando com 10 tarefas por minuto. Isso é devido à forte migração de nossos workers entre diferentes filas de tarefas e seu status atual ocupado/ocioso. Com volumes como 1 tarefa por minuto você não vai notar qualquer melhora na qualidade.

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_CAPCHA_ID. É permitido enviar apenas um report por tarefa.

Endereço: https://api.anti-captcha.com/reportCorrectRecaptcha
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/reportCorrectRecaptcha
        


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."
}