API 오류 목록
이 목록은 API에서 발생할 수 있는 오류 목록으로, 개발자께서는 모든 API 오류를 기록 및 분석하고, 앱의 버그를 수정하고 사용자에게 업데이트를 배포하는 등 적절한 조치를 적시에 취하시길 바랍니다. 저희는 동일한 요청이 계속해서 반복될 경우에 동일한 오류가 발생하는 것과 같은 "nonsense"요청으로부터 API를 보호하고 있습니다. 해당 조치로 IP 및 서브넷 차단과 일부 심각한 경우에는 계정 정지가 진행될 수 있습니다.
식별자 | 코드 | 설명 |
---|---|---|
0 | 코드 0은 "오류 없음"을 나타냅니다. | |
1 | ERROR_KEY_DOES_NOT_EXIST | 해당 시스템에서 계정 인증 키를 찾을 수 없습니다. 띄어쓰기나 표 기호 없이 올바르게 복사했는지 확인하시기 바랍니다. |
2 | ERROR_NO_SLOT_AVAILABLE | 현재 이용할 수 있는 유휴 CAPTCHA 작업자가 존재하지 않습니다. 작업을 생성하려면 클라이언트 영역의 API 설정에서 최대 입찰가를 높이거나 한산한 시간대 선택하여 진행하시기 바랍니다. |
3 | ERROR_ZERO_CAPTCHA_FILESIZE | 업로드 중인 CAPTCHA의 크기가 100바이트보다 작습니다. |
4 | ERROR_TOO_BIG_CAPTCHA_FILESIZE | 업로드하려는 CAPTCHA의 크기가 500,000바이트를 초과하였습니다. |
10 | ERROR_ZERO_BALANCE | 계정에서 보유하고 있는 잔고가 O 또는 마이너스입니다. |
11 | ERROR_IP_NOT_ALLOWED | 사용자의 현재 계정 키로는 IP에서 요청을 진행할 수 없습니다. 클라이언트 영역 내 API 설정에 있는 IP 목록 섹션을 참고하시기 바랍니다. |
12 | ERROR_CAPTCHA_UNSOLVABLE | 5명의 작업자가 CAPTCHA를 풀지 못했습니다. 저희 작업자들이 시간을 들여 해당 작업을 수행하였으므로 이러한 작업에 대한 비용이 고객에게 청구됩니다. |
13 | ERROR_BAD_DUPLICATES | 추측 횟수가 부족하여 100% 인식 기능이 작동하지 않았습니다. |
14 | ERROR_NO_SUCH_METHOD | 존재하지 않는 메서드를 사용한 API 요청이 발생하였습니다. 일반적으로 해당 오류는 프로그래머가 메서드 이름을 잘못 입력한 경우에 발생합니다. |
15 | ERROR_IMAGE_TYPE_NOT_SUPPORTED | EXIF 헤더에서 CAPTCHA 파일 유형을 확인할 수 없거나 이미지 형식이 지원되지 않습니다. 허용되는 형식은 JPG, GIF, PNG이며, 이미지에는 이미지 형식에 대한 정보가 포함된 EXIF 헤더가 포함되어 있어야 합니다. |
16 | ERROR_NO_SUCH_CAPCHA_ID | 요청한 CAPTCHA가 활성 CAPTCHA 목록에 없거나 만료되었습니다. CAPTCHA는 작업자가 작업을 완료한 후 60초 후에 API에서 제거되며, 이 시간 동안 사용자의 앱은 전체 작업 결과 투표와 올바름/오류 보고 요청을 전송합니다. |
21 | ERROR_IP_BLOCKED | 부적절한 API 사용으로 인해 사용자의 IP가 차단되었습니다. 해당 이유는 여기서 확인하시기 바랍니다. |
22 | ERROR_TASK_ABSENT | "task" 속성이 비어 있거나 createTask 메서드에서 설정이 되어 있지 않았습니다. |
23 | ERROR_TASK_NOT_SUPPORTED | 지원되지 않는 작업 유형이거나 올바르게 입력되지 않았습니다. 작업 속성에서 "type" 속성을 확인하시기 바랍니다. |
24 | ERROR_INCORRECT_SESSION_DATA | 연속 사용자 에뮬레이션에 필요한 값 중 일부가 누락되었습니다. API 출력에 누락된 항목에 대한 자세한 정보가 포함되어 있으니 확인하시기 바랍니다. |
25 | ERROR_PROXY_CONNECT_REFUSED | 작업 프록시에 연결할 수 없습니다. 연결이 거부되었습니다. |
26 | ERROR_PROXY_CONNECT_TIMEOUT | 작업 프록시에 연결할 수 없습니다. 연결 시간이 초과되었습니다. |
27 | ERROR_PROXY_READ_TIMEOUT | 작업 프록시의 타임아웃을 읽는 중입니다 |
28 | ERROR_PROXY_BANNED | 대상 서비스에서 프록시 IP를 차단하였습니다. |
29 | ERROR_PROXY_TRANSPARENT | 프록시 확인 상태에서 작업이 거부되었습니다. 당사의 서버 IP를 숨기려면 프록시가 투명하지 않아야 합니다. 당사의 프록시 검사기를 사용하여 프록시를 디버그하시기 바랍니다. |
30 | ERROR_RECAPTCHA_TIMEOUT | reCAPTCHA 작업 시간이 초과되었습니다. 해당 문제는 프록시 서버 속도가 느리거나 Goole 서버 문제가 원인일 수 있습니다. |
31 | ERROR_RECAPTCHA_INVALID_SITEKEY | CAPTCHA 제공업체에서 해당 사이트 키가 올바르지 않다고 보고하였습니다. |
32 | ERROR_RECAPTCHA_INVALID_DOMAIN | CAPTCHA 제공업체에서 해당 사이트 키의 도메인이 유효하지 않다고 보고하였습니다. |
33 | ERROR_RECAPTCHA_OLD_BROWSER | CAPTCHA 제공업체에서 브라우저 사용자 에이전트가 자바스크립트와 호환되지 않는다고 보고하였습니다. |
34 | ERROR_TOKEN_EXPIRED | CAPTCHA 제공업체 서버에서 추가 변수 토큰이 만료되었다고 보고하였습니다. 새 토큰으로 다시 시도하시기 바랍니다. |
35 | ERROR_PROXY_HAS_NO_IMAGE_SUPPORT | 프록시에서는 Google 서버에서의 이미지 데이터 전송이 지원되지 않습니다. 당사의 프록시 검사기를 사용하여 프록시를 디버그하시기 바랍니다. |
36 | ERROR_PROXY_INCOMPATIBLE_HTTP_VERSION | 프록시에서는 2,000바이트 길이의 긴 GET 요청과 SSL 연결이 지원되지 않습니다. 당사의 프록시 검사기를 사용하여 프록시를 디버그하시기 바랍니다. |
49 | ERROR_PROXY_NOT_AUTHORISED | 프록시 로그인 및 비밀번호가 올바르지 않습니다. 당사의 프록시 검사기를 사용하여 프록시를 디버그하시기 바랍니다. |
51 | ERROR_INVALID_KEY_TYPE | 전달된 사이트 키는 다른 reCAPTCHA 유형에서 가져온 것입니다. V2, V2-Invisible, 또는 V3로 풀어 보시기 바랍니다. |
52 | ERROR_FAILED_LOADING_WIDGET | 작업자 브라우저에서 CAPCHA 공급자 위젯을 불러오지 못하였습니다. 새 작업 전송을 시도하시기 바랍니다. |
53 | ERROR_VISIBLE_RECAPTCHA | 일반 reCAPTCHA v2를 reCAPTCHA V2 Invisible로 처리하려는 시도가 발견되었습니다. API 페이로드에서 'isInvisible' 플래그를 제거하시기 바랍니다. |
54 | ERROR_ALL_WORKERS_FILTERED | reportIncorrectRecaptcha 메서드로 필터링되지 않은 작업자가 남아 있지 않습니다. |
55 | ERROR_ACCOUNT_SUSPENDED | 중대한 사유로 인해 시스템에서 사용자의 계정을 일시 정지하였습니다. 자세한 내용은 지원팀에 문의하시기 바랍니다. |
56 | ERROR_TEMPLATE_NOT_FOUND | 작업 생성 과정에서 해당 템플릿의 이름을 AntiGate 템플릿을 찾을 수 없습니다. |
57 | ERROR_TASK_CANCELED | 작업자가 AntiGate 작업을 취소하였습니다. 취소 사유는 "errorDescription" 필드를 참조하시기 바랍니다. |