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 -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
JSON com um erro
{
"errorId":0,
"status":"success"
}