Menu

reportCorrectRecaptcha: reporta tokens de Recaptcha resolvidos corretamente

Use este método juntamente com reportIncorrectRecaptcha para o suas tarefas Recaptcha V3 e Recaptcha V2 Enterprise. Relatórios para Recaptcha V2 estão, atualmente, sendo aceitos, mas eventualmente ignorados. Nossa qualidade para V2 é de, aproximadamente 99%, e você não precisa construir uma lista de permissões de workers bem sucedidos.

Por trás, vamos colocar o worker que você relatou em uma lista de permissões, e na próxima rodada de atribuição de workers para seus captchas, nosso sistema vai combinar essa lista com seus captchas. Se algum dos workers relatados estiver online e ocioso, ele será colocado na frente da fila para atribuição à sua nova tarefa. O sistema manterá esse registro para a próxima hora e poderá removê-lo se você enviar um relatório reportIncorrectRecaptcha para uma tarefa, que é executado pelo mesmo worker da lista de permissões.
Resumindo, o reportCorrectRecaptcha adiciona workers à sua lista de permissões, enquanto o reportIncorrectRecaptcha remove workers dela.

A comunicação de tokens corretamente resolvidos funciona em volumes significativos, a partir de 10 tarefas por minuto. Isto deve-se à forte migração dos nossos workers entre diferentes filas de tarefas e ao seu atual estado ocupado/ocioso. Com volumes como 1 tarefa por minuto, não notará nenhuma melhoria na qualidade.

Os reports devem ser enviados dentro de 60 segundos da conclusão da tarefa. Se você fizer um pedido depois desse período, a API vai retornar o erro ERROR_NO_SUCH_CAPCHA_ID. Apenas um report pode ser enviado por tarefa.

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

Propriedades da solicitação

PropriedadeTipoObrigatórioMotivo
clientKeyStringSim
taskIdInteiroSim

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

PropriedadeTipoMotivo
errorIdInteiroIdentificador de erro.
0 - sem erros, operação concluída com sucesso.
>0 - identificação do erro. O código de erro e sua breve descrição estão disponíveis nas propriedades errorCode e errorDescription.
errorCodeString
errorDescriptionStringCurta descrição do erro
statusStringO resultado da operação. Você receberá um código de erro ou status="success" quando a reclamação for aceita.

Exemplo de resposta

JSON sem erros
JSON com um erro
{
    "errorId":0,
    "status":"success"
}