reportCorrectRecaptcha: 올바르게 풀린 reCAPTCHA 토큰 보고하기
Recaptcha V3 및 Recaptcha V2 Enterprise 작업에 reportIncorrectRecaptcha와 함께 이 메서드를 사용해 보시기 바랍니다. 현재 reCAPTCHA V2에 대한 보고의 경우, 접수는 되고 있으나 최종적으로는 처리되고 있지 않습니다. 당사의 V2 품질의 경우, 이는 약 99%로, 따라서 사용자가 우수한 작업자를 대상으로 한 화이트리스트를 구축할 필요가 없습니다.
배후 사정을 말씀드리면, 사용자가 보고한 작업자를 당사가 화이트리스트에 등록하며, 다음번 작업자를 사용자의 CAPTCHA에 배정할 때, 당사의 시스템이 이 화이트리스트와 사용자의 CAPCHA와 매칭시킵니다. 보고된 작업자 중 온라인 상태이면서 유휴 상태인 작업자가 있는 경우, 해당 작업자가 새 작업 배정 시 가장 앞줄에 배치됩니다. 해당 기록은 시스템에 다음 1시간 동안 보관되며, 동일한 화이트리스트에 등록된 작업자가 수행하는 작업에 대하여 사용자가 reportIncorrectRecaptcha 보고서를 제출하는 경우, 이 기록은 삭제될 수 있습니다.
즉, reportCorrectRecaptcha는 작업자를 화이트리스트에 추가하며, reportIncrectRecaptcha는 작업자를 화이트리스트에서 제거합니다.
올바르게 풀린 토큰을 보고하는 작업의 경우, 분당 작업 10개부터 시작해서 현저하게 많은 양을 처리하는 식으로 증가합니다. 이는 작업자들이 서로 다른 작업 대기열과 현재 작업 중/유휴 상태를 계속 오가기 때문에 그런 것으로, 분당 작업 1개와 같은 작업량에서는 품질 개선을 체감하기 어렵습니다.
보고는 작업 완료 후 60초 이내에 전송하여야 합니다. 해당 시간이 지난 후 보고를 전송하는 경우에는 API가 ERROR_NO_SUCH_CAPCHA_ID 오류를 반환합니다. 작업당 하나의 보고만 전송할 수 있습니다.
주소: https://api.anti-captcha.com/reportCorrectRecaptcha
메서드: POST
Content-type: application-json
속성 요청
속성 | 유형 | 필수 | 목적 |
---|---|---|---|
clientKey | 문자열 | 예 | |
taskId | 정수 | 예 |
예제 요청
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
응답 구조
속성 | 유형 | 목적 |
---|---|---|
errorId | 정수 | 오류 식별자. 0 - 오류 없음. 작업이 성공적으로 완료되었습니다. >0 - 오류 식별자. 오류 코드 및 이에 대한 간단한 설명은 errorCode 및 errorDescription 속성에서 확인하실 수 있습니다. |
errorCode | 문자열 | |
errorDescription | 문자열 | 오류 항목에 대한 간단한 설명 |
status | 문자열 | 작업 결과. 불만 사항이 접수되면 오류 코드 또는 상태="성공"이 표시됩니다. |
응답 예제
JSON (오류 없음)
JSON (오류 있음)
{
"errorId":0,
"status":"success"
}