Documentation Index

Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Application

Prev Next

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

NAVER API HUB 지원 사양을 확인했다면 NAVER API HUB 이용을 시작하기 위한 준비를 완료한 것입니다. 이제 다음으로 할 일은 NAVER API HUB에 대한 이용 신청을 진행하고 관리하는 것입니다. NAVER API HUB 이용 신청 및 이용에 대한 관리는 네이버 클라우드 플랫폼 콘솔에서 진행합니다.

참고

NAVER API HUB는 API로 제공하는 서비스이기 때문에 네이버 클라우드 플랫폼 콘솔에서는 이용 신청과 해지, 이용 관리만 가능합니다.

이 가이드를 통해 학습하게 되는 내용을 정리하면 다음과 같습니다.

이용 신청

NAVER API HUB 서비스를 이용 신청하는 방법은 다음과 같습니다.

참고

API 서비스 이용 약관 동의는 네이버 클라우드 플랫폼의 AI·NAVER API 서비스 최초 이용 시 진행합니다. 이미 AI·NAVER API의 다른 서비스를 이용 중인 경우 이 과정은 생략되므로 Application 등록으로 이동해 주십시오.

  1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
  2. 콘솔 화면 우측 상단의 리전 & 플랫폼 버튼을 클릭해 주십시오.
  3. 이용 중인 리전과 플랫폼을 선택한 후 [적용] 버튼을 클릭해 주십시오.
  4. 콘솔 화면 좌측 상단의 Menu를 클릭해 주십시오.
  5. Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
  6. Subscription 메뉴를 클릭해 주십시오.
  7. [서비스 이용 신청] 버튼을 클릭해 주십시오.
  8. 팝업 화면이 나타나면 이용 약관 및 개인정보 제3자 제공 동의에 관한 안내를 확인한 후, 동의하는 경우 하단의 체크 박스를 클릭해 주십시오.
  9. [확인] 버튼을 클릭해 주십시오.
  10. 등록할 수 있는 Application 목록을 확인하고 다음 과정을 진행해 주십시오.
참고

Application을 등록하면 Application 한 개 당 고유한 Client ID와 Client Secret 값이 생성됩니다. Client ID와 Client Secret 값은 API 호출 시 HTTP 헤더값에 포함되어 전송됩니다. API 호출 방법에 대한 자세한 설명은 네이버 클라우드 플랫폼 API 가이드의 NAVER 연동 API 호출을 참조해 주십시오.

Application 등록

API 서비스 이용 약관에 동의한 후 Application을 등록해야 합니다. Application은 NAVER API HUB의 API를 이용하기 위해 반드시 필요합니다. Application을 등록하면 Application 한 개 당 고유한 Client ID와 Client Secret 값이 생성되는데, API 호출 시 Client ID와 Client Secret 값을 HTTP 헤더값에 포함하여 전송하기 때문입니다.

참고

API 호출 방법에 대한 자세한 설명은 네이버 클라우드 플랫폼 API 가이드의 NAVER 연동 API 호출을 참고해 주십시오.

Application을 등록하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.

  2. Application 메뉴를 클릭해 주십시오.

  3. [Applicaiton 등록] 버튼을 클릭해 주십시오.

  4. API 선택 화면에서 등록을 원하는 API를 선택 후, [다음] 버튼을 클릭해 주십시오.

    • 우측 상단에서 카테고리 선택 및 검색이 가능합니다.
    • 각 API 카드 내 [요금 안내] 및 [개발 가이드] 를 확인할 수 있습니다.
    • 제공하는 API는 다음과 같습니다.
      카테고리 API 설명 월 최대 호출 건수
      NAVER 검색 뉴스 네이버 뉴스 검색 결과 조회 775,000건
      블로그 네이버 블로그 검색 결과 조회
      지역 네이버 지역 서비스 업체·기관 검색 결과 조회
      지식iN 네이버 지식iN 검색 결과 조회
      카페 네이버 카페글 검색 결과 조회
      백과사전 네이버 백과사전 검색 결과 조회
      이미지 네이버 이미지 검색 결과 조회
      성인 검색어 판별 입력 검색어의 성인 검색어 여부 판별
      오타변환 한/영 키 오입력 검색어의 변환 결과 조회
      웹문서 네이버 웹 문서 검색 결과 조회
      Data Lab 쇼핑 인사이트 쇼핑 분야·키워드별 검색 클릭 추이 조회(기기·성별·연령별 세분화) 50,000건
      검색어 트렌드 주제어로 묶은 검색어의 통합검색 검색 추이 조회 50,000건

  5. Application 정보 입력 화면에서 선택한 Application 정보 확인 및 Application 이름을 입력해 주십시오.

    • 선택한 Application: 이전 단계에서 선택한 API 항목
    • Application 이름: Application 이름 입력
      • 최대 20 자까지 입력 가능
      • 영문자, 숫자, 특수문자(-)만 입력 가능

  6. [완료] 버튼을 클릭해 주십시오.

    • Application이 등록됩니다.

Application 정보 확인

등록된 Application 목록은 네이버 클라우드 플랫폼 콘솔의 Application Services > NAVER API HUB > Application 메뉴에서 확인할 수 있습니다. Application 목록에서 Application 정보를 확인하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
  2. Application 메뉴를 클릭해 주십시오.
  3. Application 정보를 확인해 주십시오.
    • Application: Application 등록 시 설정한 앱의 이름
    • Category: Application 등록 시 선택한 서비스
    • API: Application 등록 시 선택한 서비스
    • 당일 사용량: API별 실시간 일별 사용량 (UTC+9 기준)
    • 당월 사용량: API별 실시간 월별 사용량 (UTC+9 기준)
    • 등록일시: Application을 등록한 일시
    • 설정: API 호출 이용 한도와 특정 값(%) 초과 시 알림 설정
  4. [인증 정보] 버튼을 클릭해 주십시오.
    naverapihub_application_app_01_ko
  5. 인증 정보 창이 나타나면 인증 정보를 확인해 주십시오.
    • Application Key
      • Application 이름: Application을 구분하는 이름
      • Client ID (X-NCP-APIGW-API-KEY-ID): 인증에 필요한 ID로 헤더 또는 쿼리 스트링에 'X-NCP-APIGW-API-KEY-ID'로 입력 naverapihub-ico_01 클릭 시 값 복사 가능
      • Client Secret (X-NCP-APIGW-API-KEY): 인증에 필요한 SecretKey 비밀번호로 헤더 또는 쿼리 스트링에 'X-NCP-APIGW-API-KEY'로 입력 naverapihub-ico_01 클릭 시 값 복사 가능하며 [재발급] 버튼 클릭 시 값 변경 가능
  6. [확인] 버튼을 클릭해 주십시오.
주의

Client ID와 Client Secret이 외부에 노출되지 않도록 주의해 주십시오. 보안이 우려되는 경우 7.에서 인증 정보를 새로운 값으로 재발급해 주십시오.

Application 수정

등록한 Application 정보를 수정하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
  2. Application 메뉴를 클릭해 주십시오.
  3. 수정할 Application의 naverapihub_hambarger_button 버튼을 클릭해 주십시오.
  4. [Application 수정] 버튼을 클릭해 주십시오.
  5. 필요한 정보를 수정한 다음 [저장] 버튼을 클릭해 주십시오.
    • Application 정보가 수정됩니다.

Application 삭제

등록한 Application을 삭제하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
  2. Application 메뉴를 클릭해 주십시오.
  3. 삭제할 Application의 naverapihub_hambarger_button 버튼을 클릭해 주십시오.
  4. [Application 삭제] 버튼을 클릭해 주십시오.
  5. [Application 삭제] 창에서 Application 이름을 확인 후 [확인] 버튼을 클릭해 주십시오.
    • Application이 삭제됩니다.

이용 관리

등록한 Application별 이용 현황을 확인하고 과금 관리를 위한 다양한 옵션을 설정할 수 있습니다.

당일/당월 이용량 확인

당일 이용량과 당월 이용량을 확인하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
  2. Application 메뉴를 클릭해 주십시오.
  3. Application 목록에서 이용량을 확인할 Application의 당일 이용량과 당월 이용량의 실시간 이용 현황을 확인해 주십시오.
    • UTC+9 기준
    • 한국 시간 기준으로 00:00 AM에 일별 이용량이 0으로 초기화
참고

실제 당일/당월 사용량은 반영되기까지 약 1분 정도 시간이 소요됩니다.

이용 한도 설정

서비스 이용 요금이 과도하게 청구되는 것을 방지하기 위해 일별, 월별 이용 한도를 직접 설정할 수 있습니다. 이용 한도를 설정하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.

  2. Application 메뉴를 클릭해 주십시오.

  3. . Application 목록에서 이용 한도를 변경할 Application의 [한도 및 알림] 버튼을 클릭해 주십시오.
    naverapihub_application_app_02_ko

  4. [한도 설정] 탭 메뉴에서 월별 한도 값과 일별 한도 값을 입력해 주십시오.
    naverapihub_application_limit_01_ko

  5. [저장] 버튼을 클릭해 주십시오.

참고

이용 한도를 변경한 이력은 한도 및 알림 팝업 창의 [한도 변경 이력] 탭 메뉴에서 확인할 수 있습니다.

임계치 알림 설정

사용자가 설정한 일별/월별 한도 값의 특정 사용률을 초과한 경우, 이메일 또는 SMS로 알림을 받을 수 있습니다.
임계치 알림을 설정하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
  2. Application 메뉴를 클릭해 주십시오.
  3. Application 목록에서 이용 한도를 변경할 Application의 [한도 및 알림] 버튼을 클릭해 주십시오.
  4. [한도 설정] 탭 메뉴에서 월별 한도 설정 또는 일별 한도 설정 항목의 체크 박스를 클릭하여 선택해 주십시오.
  5. 알림 기준이 될 임계치 값(%)을 선택해 주십시오.
    naverapihub_application_limit_02_ko
    • 70%을 선택한 경우, 70%, 80%, 90%, 100%에 알림
    • 90%을 선택한 경우, 90%, 100%에 알림
  6. [저장] 버튼을 클릭해 주십시오.
  7. 통보 대상 설정을 참고하여 임계치 알림 설정을 받을 주소를 입력해 주십시오.
참고

임계치 알림을 설정했더라도 통보 대상자를 설정하지 않으면 알림이 수신되지 않습니다. 반드시 통보 대상자를 설정해 주십시오.

통보 대상 설정

사용자가 설정한 일별/월별 한도 값의 특정 사용률을 초과한 경우 알림을 받을 수신자와 수신 방법을 설정하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
  2. Application 메뉴를 클릭해 주십시오.
  3. Application 목록에서 이용 한도를 변경할 Application의 [한도 및 알림] 버튼을 클릭해 주십시오.
  4. [통보대상 설정] 탭 메뉴를 클릭해 주십시오.
  5. 통보 대상 담당자를 선택하고 통보 방법을 선택한 후 [추가] 버튼을 클릭해 주십시오.
    • 신규 담당자를 추가하기 위해 Cloud Insight(Monitoring)로 이동하려면 [통보 대상 관리] 버튼 클릭
  6. 통보 대상자 설정이 완료되면 [저장] 버튼을 클릭해 주십시오.
참고

통보 대상 설정에서는 등록된 통보 대상 담당자만 선택할 수 있습니다. 새로운 담당자를 등록하는 작업은 Cloud Insight의 Notification Recipient 메뉴에서 수행할 수 있습니다. 자세한 설명은 Notification Recipient 사용 가이드 대상자 추가를 참고해 주십시오.

이용 해지

NAVER API HUB 이용 해지를 위해서는 생성한 NAVER API HUB의 Application을 모두 삭제해야 합니다. Application 삭제 후, NAVER API HUB 이용을 해지하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
  2. 콘솔 화면 우측 상단의 리전 & 플랫폼 버튼을 클릭해 주십시오.
  3. 이용 중인 리전과 플랫폼을 선택한 후 [적용] 버튼을 클릭해 주십시오.
  4. 콘솔 화면 좌측 상단의 Menu를 클릭해 주십시오.
  5. Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
  6. Subscription 메뉴를 클릭해 주십시오.
  7. [상품 이용 중] 버튼을 클릭한 후 상품 이용 해지를 클릭해 주십시오.
  8. 서비스 이용 해지 팝업 창의 내용을 확인한 후 [확인] 버튼을 클릭해 주십시오.
  9. 서비스 이용 해지 팝업 창의 [확인] 버튼을 클릭해 주십시오.
    • 이용이 해지됩니다.
사업자등록번호: 129-86-31394 통신판매업신고번호:제2009-경기성남-0510호
대표이사: 김유원 주소: 경기도 성남시 분당구 불정로 6 네이버 그린팩토리 17~26층, 13561 고객지원 대표전화: 1544-5876
© NAVER Cloud Corp. All Rights Reserved.