CAPTCHA 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

CAPTCHA는 사람과 컴퓨터를 판별해 자동 입력을 방지해주는 네이버 클라우드 플랫폼의 서비스입니다. CAPTCHA 서비스에서는 사람의 눈으로 식별 가능한 문자가 포함된 이미지를 전송하고 입력값을 검증하는 CAPTCHA (Image)와 숫자가 포함된 음성 메시지를 전송하고 입력값을 검증하는 CAPTCHA (Audio) API를 RESTful 형태로 제공합니다.

CAPTCHA 공통 설정

CAPTCHA API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

CAPTCHA (Image) 키 발급, 입력값 비교: https://naveropenapi.apigw.gov-ntruss.com/captcha/v1
CAPTCHA (Image) 이미지 파일 요청: https://naveropenapi.apigw.gov-ntruss.com/captcha-bin/v1
CAPTCHA (Audio) 키 발급, 입력값 비교: https://naveropenapi.apigw.gov-ntruss.com/scaptcha/v1 
CAPTCHA (AUdio) 음성 파일 요청: https://naveropenapi.apigw.gov-ntruss.com/scaptcha-bin/v1

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-api-key-id Required 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client ID
x-ncp-apigw-api-key Required 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client Secret
참고

네이버 클라우드 플랫폼 콘솔에서 Application을 등록하여 API 사용에 필요한 인증 정보(Client ID, Client Secret)를 발급받는 방법은 CAPTCHA 사용 가이드를 참조해 주십시오.
콘솔에서 Application 등록 후 사용할 API가 선택되어 있는지 [수정] 버튼을 클릭하여 확인해 주십시오. 선택되어 있지 않으면 429(Quota Exceed) 오류가 발생합니다.

응답

공통 응답 형식을 설명합니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

HTTP 상태 코드 코드 메시지 설명
400 CT002 Unissued image or wav 이미지 또는 음성 파일이 발급되지 않음
403 CT001 Invalid Key 만료되거나 없는 키
500 CT500 System Error 내부 서버 오류

CAPTCHA API

CAPTCHA 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
CAPTCHA (Image) > 키 발급 캡차 이미지 키 발급
CAPTCHA (Image) > 이미지 파일 요청 캡차 이미지 파일 요청
CATPCHA (Image) > 입력값 비교 캡차 이미지 값과 사용자 입력값 비교
CAPTCHA (Audio) > 키 발급 캡차 오디오 키 발급
CAPTCHA (Audio) > 이미지 파일 요청 캡차 오디오 파일 요청
CATPCHA (Audio) > 입력값 비교 캡차 오디오 값과 사용자 입력값 비교

CAPTCHA 연관 리소스

CAPTCHA API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.