UNLOCK API
API 키 받기
오류 코드
MarkdownOpenAPI

오류 코드

JSON 방식 메서드는 errorId 1과 errorCode, errorDescription을 돌려줘요. in.php와 res.php는 오류 이름을 글자로 돌려주고, json=1이면 {"status":0,"request":"ERROR_NAME"}을 돌려줘요. 둘 다 HTTP 상태는 200이니 꼭 본문을 읽으세요.

키, 계정, 한도

  • ERROR_KEY_DOES_NOT_EXIST
    돌려주는 곳: JSON안 빠짐

    키가 틀렸어요. 계정 화면에서 다시 복사하세요. (in.php, res.php에서는 ERROR_WRONG_USER_KEY)

  • ERROR_WRONG_USER_KEY
    돌려주는 곳: in.php, res.php안 빠짐

    in.php와 res.php: 키가 틀렸어요. 계정 화면에서 다시 복사하세요.

  • ERROR_IP_NOT_ALLOWED
    돌려주는 곳: 둘 다안 빠짐

    계정의 허용 목록에 없는 IP에서 온 요청이에요. 계정 화면에서 IP를 추가하세요.

  • ERROR_IP_BANNED
    돌려주는 곳: 둘 다안 빠짐

    이 계정은 막혀 있어요. 계정 화면에서 고객 지원에 문의하세요.

  • ERROR_ZERO_BALANCE
    돌려주는 곳: 둘 다안 빠짐

    잔액이 작업 비용보다 적어요. 충전하세요. 비용은 빠지지 않았어요.

  • ERROR_TOO_MANY_REQUESTS
    돌려주는 곳: 둘 다안 빠짐

    요청이 너무 많아요. 결과 확인을 5초 간격으로 줄이세요.

작업을 보낼 때 거절

  • ERROR_TASK_NOT_SUPPORTED
    돌려주는 곳: JSON안 빠짐

    모르는 작업 종류이거나 지금 받지 않는 종류예요. 이름을 확인하세요.

  • ERROR_BAD_PARAMETERS
    돌려주는 곳: 둘 다안 빠짐

    필수 항목이 없거나 형식이 틀렸어요.

  • ERROR_PAGEURL
    돌려주는 곳: 둘 다안 빠짐

    websiteURL(pageurl)이 없거나 http(s)로 시작하는 전체 주소가 아니에요.

  • ERROR_GOOGLEKEY
    돌려주는 곳: in.php, res.php안 빠짐

    in.php reCAPTCHA 요청에 googlekey가 없어요.

  • ERROR_BAD_PROXY
    돌려주는 곳: 둘 다안 빠짐

    프록시 작업에는 proxyAddress와 proxyPort가 필요해요.

  • ERROR_ZERO_CAPTCHA_FILESIZE
    돌려주는 곳: 둘 다안 빠짐

    이미지가 없거나 너무 작아요.

  • ERROR_TOO_BIG_CAPTCHA_FILESIZE
    돌려주는 곳: 둘 다안 빠짐

    이미지가 100 KB보다 커요.

  • ERROR_IMAGE_TYPE_NOT_SUPPORTED
    돌려주는 곳: 둘 다안 빠짐

    이미지가 올바른 base64가 아니에요.

  • ERROR_NO_SLOT_AVAILABLE
    돌려주는 곳: 둘 다안 빠짐

    지금 요청이 몰려 작업을 받을 수 없어요. 몇 초 뒤에 다시 보내세요. 비용은 빠지지 않았어요.

결과 확인

  • CAPCHA_NOT_READY
    돌려주는 곳: in.php, res.php안 빠짐

    in.php, res.php 전용: 아직 푸는 중이에요. 5초 뒤에 다시 확인하세요.

  • ERROR_WRONG_CAPTCHA_ID
    돌려주는 곳: 둘 다안 빠짐

    내 계정에 그 번호의 작업이 없어요.

  • ERROR_WRONG_ID_FORMAT
    돌려주는 곳: in.php, res.php안 빠짐

    res.php: id가 없거나 숫자가 아니에요.

  • ERROR_CAPTCHA_UNSOLVABLE
    돌려주는 곳: 둘 다환불

    시간 안에 못 풀었어요. 비용은 잔액으로 돌아왔어요.

  • ERROR_PROXY_CONNECTION_FAILED
    돌려주는 곳: 둘 다환불

    풀이 쪽에서 내 프록시로 접속하지 못했어요. 프록시가 켜져 있는지, 로그인 정보가 맞는지 확인하세요.

작업은 접수된 뒤에도 실패할 수 있어요. 예를 들어 페이지 항목이 틀렸을 때예요. 그러면 getTaskResult가 이유를 errorCode(위 코드 중 하나)로 돌려주고, 비용은 이미 잔액으로 돌아와 있어요.