CAPTCHA 개요

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

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

공통 설정

클라이언트 아이디는 네이버 클라우드 플랫폼 콘솔에서 애플리케이션을 등록해 발급받습니다.

콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >
AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 [CAPTCHA (Image) or CAPTCHA (Audio)] 가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

API 명	메서드	요청 URL	출력 포맷
이미지 캡차 키 발급/비교	GET	`https://naveropenapi.apigw.gov-ntruss.com/captcha/v1/nkey`	JSON
이미지 캡차 이미지 요청	GET	`https://naveropenapi.apigw.gov-ntruss.com/captcha-bin/v1/ncaptcha`	JPG
음성 캡차 키 발급/비교	GET	`https://naveropenapi.apigw.gov-ntruss.com/scaptcha/v1/skey`	JSON
음성 캡차 파일 요청	GET	`https://naveropenapi.apigw.gov-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"
  }
}

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	conent-length 초과 (10MB)
503	500	Endpoint Error	엔드포인트 연결에러
504	510	Endpoint Timeout	엔드포인트 연결시간 초과
500	900	Unexpected Error	예외처리가 안된 에러

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

이 문서가 도움이 되었습니까?

태그