NAVER 연동 API 사용 가이드

개요

NAVER 연동 API는 HTTP 헤더에 Client IDClient Secret 값만 전송하면 바로 호출하여 사용할 수 있는 Open API들로서, Maps, Clova, Papago와 같은 상품이 해당됩니다. NAVER 연동 API는 지도, 좌표변환, 단축 URL을 비롯 음성인식, 기계번역, 음성합성과 같은 오픈 API 들이 제공되고 있습니다.

지원하는 NAVER 연동 API

상품명 API
Clova Clova Speech Synthesis
Clova Speech Recognition
Clova Face Recognition
Papago Papago NMT
Papago Language Detection
Papago Korean Name Romanizer
Maps Static Map
Tile Map
Directions
Search Places
Geocoding
Reverse Geocoding
NAVER nShortURL
CAPTCHA (Image)
CAPTCHA (Audio)
Search Trend

NAVER 연동 API를 사용하기 위해서는 아래와 같은 단계로 진행되어야 합니다.
1. Application 등록하기
2. 인증 정보 확인하기
3. 해당 상품 선택하기

Application 등록하기

API를 호출할 때, HTTP 헤더값에 Client IDClient Secret 값을 포함해서 전송해야하기 때문에 먼저 Application을 등록해야합니다.

  1. 콘솔에서 [All Product]>[AI·NAVER API]>[Application 등록] 버튼을 선택합니다.
  2. “AI·NAVER API 이용 약관” 및 “NAVER API 서비스 이용약관”에 동의를 하신 후에 Application 등록을 진행합니다.
  3. 동의를 완료한 후에, AI NAVER Service에서 이용할 Application 이름을 등록합니다.
    • 이름은 최대 40 자까지 가능하나 추후 추가되는 Service의 성격에 따라 화면에 출력되는 Application 이름으로 쓰일 수 있으므로 가급적이면 10 자 이내의 간결한 이름이 좋습니다.
  4. Application에서 이용할 Service를 선택하여 체크합니다.
    • 네이버 클라우드 플랫폼을 통해 연동할 수 있는 Service를 선택합니다.
  5. 선택한 Application에서 이용할 서비스 환경 정보를 입력하고 등록 버튼을 클릭합니다.
    • 서비스 URL은 복수 선택이 가능하며, Android 앱 패키지나 iOS Bundle ID는 각각 하나씩만 등록이 가능합니다.
  6. 등록이 완료되면, AI·NAVER API > Application에 등록된 Application의 리스트가 보이게 됩니다.
    • 서비스 구분 : 선택한 서비스들을 확인합니다.
    • 당일/당월 사용량 : Application 마다 서비스별로 실시간 사용량을 %로 확인할 수 있습니다. (UTC+0 기준입니다)
    • 한도 설정 : 이용 한도를 직접 조절할 수 있습니다.

인증 정보 확인하기

API를 호출하기 위해서 미리 해당 Application을 등록을 마친 후에 필요한 Client IDClient Secret 값을 확인하기 위해 아래의 절차와 같이 진행을 해야합니다.

중요
Client IDClient Secret 값은 API를 호출할 때, HTTP 헤더값에 포함해서 전송해야 호출이 가능합니다.
  1. AI·NAVER API > Application 리스트에서 등록된 Application을 확인한 후, App 이름 아래에 있는 인증 정보 버튼을 클릭합니다.
  2. [인증 정보] 팝업창이 뜨면, Client IDClient Secret 값을 확인할 수 있습니다.

    • Application Key

      • Application 이름 : Application을 구분하는 이름입니다.
      • Client ID (X-NCP-APIGW-API-KEY-ID) : 인증을 위한 ID과 같은 값으로 헤더 또는 쿼리 스트링에 ‘X-NCP-APIGW-API-KEY-ID’ 로 입력을 합니다.
      • Client Secret (X-NCP-APIGW-API-KEY) : 인증을 위한 SecretKey 비밀번호와 같은 성격이며, 헤더 또는 쿼리 스트링에 ‘X-NCP-APIGW-API-KEY’로 입력을 합니다.
      • Client 상에 노출되지 않도록 주의해야 하며, 보안을 위한 재발급이 가능합니다.
    • 서비스 환경

      • Web URL : Web SDK를 사용하기 위하여 필수로 입력해야 하는 값
      • Android 패키지 이름 : Android SDK를 사용하기 위하여 필수로 입력해야 하는 값
      • iOS Bundle ID : iOS SDK를 사용하기 위하여 필수로 입력해야 하는 값

해당 상품 선택하기

  1. 콘솔에서 All Product > AI·NAVER API > Application 변경 버튼을 선택합니다.

  2. 해당 Application이 선택되어 있는지 확인합니다.

중요
선택되어 있지 않으면 429(Quota Exceed) 오류가 발생하니 주의하시기 바랍니다.
아쉬운 점이 있다면 이야기해 주세요.
0/5000
내용을 입력해 주세요
의견 보내기