naver-openapi-guide
애플리케이션 등록
네이버 오픈 API로 개발하시려면 먼저 ‘Application-애플리케이션 등록’ 메뉴에서 애플리케이션을 등록하셔야 합니다. 애플리케이션이 정상적으로 등록되면 ‘내 애플리케이션’ 에 등록한 애플리케이션 이름으로 서브 메뉴가 생기며, 애플리케이션 하나당 유일한 클라이언트 아이디와 클라이언트 시크릿 값이 생성됩니다. 클라이언트 아이디와 클라이언트 시크릿 값은 네이버 API를 호출할 때 HTTP 헤더값에 포함해서 전송해야 호출이 가능합니다.
1.애플리케이션 등록 방법
개발자센터의 메뉴에서 ‘Application-애플리케이션 등록’ 메뉴를 선택한 다음 애플리케이션 세부 정보들를 입력합니다.
1.1. 애플리케이션 이름
이름은 최대 40자까지 가능하나, 아래와 같이 네이버 아이디로 로그인 화면에 출력되는 애플리케이션 이름이므로 가급적이면 10자 이내의 간결한 이름이 좋습니다.
1.2. 카테고리
애플리케이션의 성격에 맞는 분류 항목을 선택해주십시오.
1.3. 이용 목적
구현하실 애플리케이션에 ‘네이버 아이디로 로그인’기능이 포함되면 ‘로그인 오픈 API’에 체크해주시고, 그렇지 않으면 ‘비로그인 오픈 API’에 체크해주세요. 둘 다 사용할 경우는 모두 체크해주시면 됩니다.
- 로그인 오픈 API: ‘네이버 아이디로 로그인’의 접근 토큰(access token)을 획득해야 이용 가능한 오픈 API들로서 회원 기본 정보 조회, 블로그 글쓰기, 카페 가입 및 글쓰기, 캘린더 일정 담기 오픈 API들이 해당되며, API를 호출할 때 HTTP 헤더에 클라이언트 아이디, 시크릿 값과 함께 네이버 아이디로 로그인 API를 통해 받은 접근 토큰(access token) 값을 전송해야 합니다.
- 비로그인 오픈 API: ‘네이버 아이디로 로그인’의 접근 토큰(access token) 값 없이 HTTP 헤더에 클라이언트 아이디와 시크릿 값만 전송하면 바로 호출하여 사용할 수 있는 오픈 API들로서 지도, 검색, 좌표변환, 단축 URL을 비롯하여, 음성인식, 기계번역, 음성합성 오픈 API들이 해당됩니다.
1.4. 서비스 환경
이용 목적 항목을 ‘로그인 오픈 API’로 선택하셨을 때 입력해야 하는 항목으로, 서비스 환경에서 네이버 아이디로 로그인을 적용할 애플리케이션 종류를 선택하고 필요한 정보를 입력합니다. 서비스 환경은 복수 선택이 가능하며, 따라서 하나의 애플리케이션에 발급된 클라이언트 아이디와 시크릿 값을 안드로이드, iOS, 웹, WindowsApp 등 여러 환경에 적용할 수 있습니다. 다만 API 사용량은 클라이언트 아이디별로 합산되는 점을 감안해주시기 바랍니다.
1.5. 서비스 환경별 세부 입력사항
- 서비스 URL: http://로 시작되는 웹, 모바일 웹 서비스 URL을 입력합니다. URL 이름으로 localhost는 사용할 수 없으며, http://127.0.0.1의 형식으로 입력하셔야 합니다.
- Callback URL: 네이버 로그인 인증이 완료되면 Callback URL로 설정한 페이지로 화면이 이동됩니다. 이때 네이버 플랫폼에서는 접근 토큰 값을 URL 파라미터로 함께 전송해줍니다. Callback URL 페이지에서는 이 파라미터를 받아서 로그인 오픈 API를 호출할 때 사용하시면 됩니다.
- 다운로드 URL: 애플리케이션을 다운로드할 수 있는 앱스토어 (Google Play, App Store, 네이버 앱스토어 등)의 URL을 입력합니다. 애플리케이션이 Google Play나 네이버 앱스토어에 등록되지 않은 상태라면 임의의 URL(예: 개발사 홈페이지 URL)을 입력하고 애플리케이션이 등록된 이후에 변경하시면 됩니다.
- 안드로이드 패키지 이름: Android 애플리케이션의 경우만 해당하며, 앱의 패키지 이름을 정확히 입력합니다. 등록된 패키지 이름과 로그인을 시도하는 앱의 패키지 이름이 다른 경우 인증이 실패할 수 있습니다.
- URL Scheme: iOS 애플리케이션의 경우만 해당하며, 네이버 앱에서 수행한 로그인 인증 결과를 전달받을 URL Scheme을 입력합니다.
1.6. 담당자 연락처
애플리케이션 등록 시 최초 1회만 연락처 인증을 받으시면 됩니다. 휴대폰 또는 이메일 중 하나만 인증을 받으시면 됩니다.
2. 애플리케이션 등록 확인
애플리케이션이 정상적으로 등록되면 아래 그림과 같이 ‘내 애플리케이션’ 에 등록한 애플리케이션 이름으로 서브 메뉴가 생기며, 애플리케이션 하나당 유일한 클라이언트 아이디와 클라이언트 시크릿 값이 생성됩니다.
3. 클라이언트 아이디와 시크릿
클라이언트 시크릿 값은 클라이언트 아이디의 비밀번호와 같은 성격이며, 값을 보려면 ‘보기’ 버튼을 누르면 됩니다. ‘보기’ 버튼은 한 번 누르면 ‘재발급’ 버튼으로 바뀌며, 버튼을 누르면 클라이언트 시크릿값 변경이 가능합니다. 클라이언트 아이디와 클라이언트 시크릿 값은 네이버 API를 호출할 때 HTTP 헤더값에 포함해서 전송해야 호출이 가능합니다. 검색, 기계번역, 음성합성, 캡차, 단축 URL 등 비로그인 오픈 API 들은 지정된 HTTP 메서드로 호출하면 사용이 가능하며, 네이버 회원 프로필 조회, 블로그 글쓰기, 카페 가입 등 로그인 오픈 API 들은 OAuth 2.0 기반 네아로 API 호출을 통해 받은 접근 토큰(access token) 값을 추가로 HTTP 헤더값에 포함해서 전송해야 호출이 가능합니다.
4. 애플리케이션 등록 주의 사항
네이버에 로그인한 사용자 계정으로 애플리케이션이 등록됩니다. 애플리케이션을 등록한 네이버 아이디는 ‘관리자’ 권한을 가지게 되므로 네이버 계정의 보안에 각별히 주의해야 합니다. 회사나 단체에서 등록할 때는 추후 키 관리 등이 용이하도록 네이버 단체 회원으로 로그인해 이용할 것을 권장합니다. 단체회원 가입하기 링크
가이드 오류, API 개발문의는 개발자 포럼에 글을 올려주시기 바랍니다. 개발자포럼 가기 >