CAPTCHA 개요

Prev Next

네이버 서비스에서 사용하고 있는 이미지와 오디오 CAPTCHA기능을 고객의 서비스에 활용하여 사람과 컴퓨터를 판별해 어뷰징을 막을 수 있습니다. 회원 가입 또는 비밀번호 찾기에서 실제 사용자의 순수한 입력만 받고, 어뷰저를 가려내고 싶을 때 유용합니다.

클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급받습니다.

  1. 콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >

  2. AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.

  3. AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 CAPTCHA (Image) or CAPTCHA (Audio) 가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

API 명 메서드 요청 URL 출력 포맷
이미지 캡차
키 발급/비교		 GET https://naveropenapi.apigw-pub.fin-ntruss.com/captcha/v1/nkey JSON
이미지 캡차
이미지 요청		 GET https://naveropenapi.apigw-pub.fin-ntruss.com/captcha-bin/v1/ncaptcha JPG
음성 캡차
키 발급/비교		 GET https://naveropenapi.apigw-pub.fin-ntruss.com/scaptcha/v1/skey JSON
음성 캡차
파일 요청		 GET https://naveropenapi.apigw-pub.fin-ntruss.com/scaptcha-bin/v1/scaptcha wav 파일
헤더명 설명
X-NCP-APIGW-API-KEY-ID 앱 등록 시 발급받은 Client ID
X-NCP-APIGW-API-KEY-ID:{Client ID}
X-NCP-APIGW-API-KEY 앱 등록 시 발급 받은 Client Secret
X-NCP-APIGW-API-KEY:{Client Secret}

공통 오류

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}
JSON
HttpStatusCode ErrorCode ErrorMessage Description
400 100 Bad Request Exception protocol(https), endocing(UTF-8) 등 request 오류
401 200 Authentication Failed 인증실패
401 210 Permission Denied 권한없음
404 300 Not Found Exception 권한없음
429 400 Quota Exceeded Quota 초과
429 410 Throttle Limited Rate 초과
429 420 Rate Limited Rate 초과
413 430 Request Entity Too Large content-length 초과 (10MB)
503 500 Endpoint Error 엔드포인트 연결오류
504 510 Endpoint Timeout 엔드포인트 연결시간 초과
500 900 Unexpected Error 예외처리가 안된 오류

API 오류

HttpStatusCode ErrorCode ErrorMessage
400 CT002 Unissued imageㅣwav(음성 또는 이미지 발급을 하지 않음)
403 CT001 Invalid key. (키가 만료되거나 없는 키)
500 CT500 System error