본문 바로가기

Daum Developers

서비스

Daum Developers 콘솔 도움말

목차

Daum Developers 콘솔(이하 'Developers 콘솔'이라 합니다)은 Daum API 서비스를 이용하여 Application(이하 '앱'이라 합니다)을 개발하기 위한 강력한 기능들을 제공합니다.

Daum Developers 콘솔

Developers 콘솔을 이용하려면 Daum 회원 계정으로 로그인 후 Daum Developers 플랫폼 서비스에 가입해 주셔야 합니다.

Daum Developers 콘솔

앱 관리

Developers 콘솔은 앱을 만들거나 앱에 관련된 팀원을 관리하고, API 키를 관리하며, 트래픽 통계를 확인하는 등의 다양한 기능을 제공합니다.

앱 생성 및 삭제

앱 성격에 따라 Developers 콘솔에서 하나의 앱을 만들어 사용하거나, 다수의 앱을 만들어 사용할 수 있습니다. 또한 자신만의 테스트용 앱을 만들거나, 팀을 구성하여 공동으로 앱을 만들 수도 있습니다. 단, 회원 등급에 따라 생성할 수 있는 앱의 개수가 달라집니다.

앱 생성

사용자가 앱을 생성하는 방법에는 두가지가 있습니다. 첫번째는 앱이 하나도 없는 경우, 두번째는 앱이 하나라도 있는 경우 입니다.

앱이 하나도 없는 경우.

앱이 없는 경우

  1. Developers 콘솔로 이동합니다.
  2. 좌측 사이드 메뉴에서 앱 만들기 버튼을 클릭해주세요.
  3. 앱 이름을 입력합니다.
    앱 이름 추가
  4. 앱 생성이 완료되었습니다.
앱이 하나라도 있는 경우.

앱이 있는 경우

  1. Developers 콘솔로 이동합니다.
  2. 콘솔 Index 페이지에서 사용자에게 제공된 앱 Slot에 위치한 + 버튼을 클릭합니다.
  3. 앱 이름을 입력합니다.
  4. 앱 생성이 완료되었습니다.

앱을 생성하면, 해당 앱의 소유자가 됩니다.

앱 삭제

앱은 소유자만 삭제할 수 있으며, 아래의 단계를 거쳐 삭제된 앱의 모든 정보는 복원되지 않습니다. 앱을 삭제하면 API 키도 삭제되며, 삭제된 API 키 역시 복원되지 않음을 유의해주세요.

생성한 앱을 삭제하고 싶다면 다음을 수행하세요.

  1. Developers 콘솔로 이동합니다.
  2. 좌측 사이드 메뉴에서 삭제하고자 하는 앱을 클릭합니다.
  3. 앱의 개요 화면 하단의 앱을 영구히 삭제하기 버튼을 클릭합니다.
    앱 삭제 버튼
  4. 제공되는 레이어에서 삭제하려는 앱의 이름을 기입한 후 삭제 버튼을 클릭합니다.
    앱 이름 입력하기

앱 개수 제한

회원 등급에 따라 앱 생성 개수가 제한됩니다. 더 많은 앱을 만들기 위해서는 회원 등급의 설명에 따라 등급을 상향해주세요. 또한 앱 생성 개수의 제한이 있기 때문에, 사용하지 않는 앱은 주기적으로 삭제해주시길 권합니다.

회원 등급 테스트 서비스 비즈니스
앱 생성 가능 개수 1 3 6

앱 이름과 앱 ID

앱를 식별하는 방법은 두 가지가 있습니다. 각각의 용도에 따라 적합한 식별 방식을 이용하길 권합니다.

앱 이름과 앱 ID

앱 이름

앱 이름은 Developers 콘솔 내에서 다양하게 사용됩니다. 그러므로 명확한 구분과 사용성을 위하여 앱생성 시 타 앱과 구분하기 쉬운 이름 사용을 권장합니다. 앱 이름은 중복 생성이 가능하며, 소유자(Owner)의 권한에서 자유롭게 변경할 수 있습니다.

앱 ID

앱 ID는 앱을 만들 때 Developers 콘솔에 의해 시스템적으로 자동 할당되어 제공합니다. 고유 식별자이므로 사용자가 변경할 수 없고, 앱에 대한 기술지원 및 제휴문의 등이 필요할 경우 앱 ID를 이용하시면 보다 명확한 커뮤니케이션이 가능합니다.

앱 팀 관리

Developers 콘솔에서는 앱의 소유자만 팀원을 추가할 수 있으며, 추가한 모든 팀원에게 적절한 권한을 부여해야 합니다.

앱 팀 관리

팀원 추가

생성한 앱의 높은 사용성을 위하여 소유자는 팀원을 추가 할 수 있습니다. 팀원을 추가하면, 팀 관리 페이지에서 팀원의 권한을 쉽게 변경할 수 있습니다. (단, 팀원 추가는 필수 사항이 아닙니다.)

팀원을 추가하고자 한다면 다음을 수행하세요.

  1. Developers 콘솔로 이동합니다.
  2. 좌측 사이드 메뉴에서 앱을 선택하거나 새로 만듭니다.
  3. 좌측 사이드 메뉴에서 해당 앱의 팀 관리 메뉴를 선택합니다.
  4. 회원 추가 버튼(+)를 선택해서, 해당 팀원이 사용하는 Daum 이메일 계정을 입력하고, 권한(개발자/참조자)를 설정합니다.
    팀원 추가
  5. 해당 팀원은 Daum 이메일 계정을 확인하고 초대를 수락합니다. (수락을 해야만 앱의 팀원으로 역할을 수행할 수 있습니다.)

팀원 삭제

앱 소유자는 프로젝트에서 보안상 이슈를 포함하여 다양한 사유로 앱의 팀원을 삭제할 수 있습니다.

팀원 삭제

  1. Developers 콘솔로 이동합니다.
  2. 좌측 사이드 메뉴에서 앱을 선택하거나 새로 만듭니다.
  3. 좌측 사이드 메뉴에서 해당 앱의 팀 관리 메뉴를 선택합니다.
  4. 팀 관리 페이지에서 삭제하고자 하는 팀원 옆의 선택박스를 클릭 후 제거(-)버튼을 선택합니다.
  5. 레이어에서 삭제하고자 하는 팀원의 계정을 다시 확인하고 완료 버튼을 선택합니다.

삭제한 팀원은 언제든지 다시 추가할 수 있습니다.

팀원 권한 설정

앱의 권한을 설정하는 방법은 팀원의 추가와 동시에 수행됩니다.

  1. Developers 콘솔로 이동합니다.
  2. 좌측 사이드 메뉴에서 앱을 선택하거나 새로 만듭니다.
  3. 좌측 사이드 메뉴에서 해당 앱의 팀 관리 메뉴를 선택합니다.
  4. 회원 추가 버튼(+)을 선택해서, 해당 팀원이 사용하는 Daum 이메일 주소를 입력하고, 권한(개발자/참조자)를 설정합니다.

팀원 권한 별 역할 구분

앱에서 팀원은 자신의 권한에 따라 차등적인 역할을 수행할 수 있습니다. 각 권한별 수행할 수 있는 역할은 아래 표에서 확인할 수 있습니다.

회원 등급 소유자 개발자 참조자
앱 추가/수정/삭제 O
팀원 추가/수정/삭제 O
API 키 추가/삭제 O O
API 쿼터 추가/삭제 O O
앱 통계 확인 O O O
앱 정보 확인 O O O

소유자(Owner)

소유자는 앱을 생성한 사람입니다. 개발자나 참조자를 팀원으로 추가할 수 있지만, 소유자를 추가할 수는 없습니다. 또한, 앱을 타인에게 양도 할 수도 없습니다. 소유자가 자신이 생성한 앱에 대해 갖는 권한은 다음과 같습니다.

  1. 앱 생성, 수정 및 삭제
  2. 팀원 추가 및 삭제
  3. API 키 추가 및 삭제
  4. API 쿼터 추가 및 삭제
  5. 앱 통계 확인
  6. 앱 정보 보기

개발자(Developer)

개발자는 소유자가 개발자의 권한을 부여하여 팀원으로 초대한 사람입니다. 개발자가 자신이 참여한 앱에 갖는 권한은 다음과 같습니다.

  1. API 키 추가 및 삭제
  2. API 쿼터 추가 및 삭제
  3. 앱 통계 확인
  4. 앱 정보 보기

참조자(Viewer)

참조자는 소유자가 참조자의 권한을 부여하여 팀원으로 초대한 사람입니다. 참조자가 자신이 참여한 앱에 갖는 권한은 다음과 같습니다.

  1. 앱 통계 확인
  2. 앱 정보 보기

권한의 변경

앱의 권한을 변경하려면 다음을 수행하세요.

  1. Developers 콘솔로 이동합니다
  2. 좌측 사이드 메뉴에서 앱을 선택하거나 새로 만듭니다.
  3. 좌측 사이드 메뉴에서 해당 앱의 팀 관리 메뉴를 선택합니다.
  4. 팀 관리 페이지에서 변경하고자 하는 팀원의 권한 우측의 드랍다운 리스트를 클릭하여 권한을 변경합니다.

회원 등급

Developers 콘솔은 회원의 등급을 아래의 규칙에 따라 자동으로 지정합니다. 회원 등급에 따라 사용할 수 있는 API가 제한되고, API 트래픽 쿼터가 조정됩니다. 더 많은 API를 이용하거나 향상된 API 트래픽을 원한다면 회원 등급을 상향시키길 권합니다.

회원 등급 설명
테스트 Daum 계정으로 Developers 플랫폼 서비스 약관에 동의한 회원에게 기본으로 제공됩니다.
서비스 테스트 등급 회원 중에 실명 인증한 회원에게 제공됩니다.
비즈니스 Daum 법인 계정으로 개발자 플랫폼 서비스 약관에 동의한 회원에게 제공됩니다.

앱 소유자의 회원 등급은 앱의 등급과 연동됩니다. 즉, 앱 소유자가 '서비스' 등급이면, 앱은 '서비스' 등급의 앱 생성 개수 및 API 트래픽 쿼터 등이 제한됩니다.

API 키

앱을 생성한 뒤 API 키를 생성할 수 있습니다. 앱과 API 키는 1:N으로 매칭됩니다. 앱의 소유자와 개발자는 API 키를 추가 및 삭제할 수 있으며, 앱의 등급에 따라 키 발급 개수가 제한됩니다.

API 키

API 키 추가

API 키와 플랫폼은 1:1 매칭되며, 선택한 플랫폼에 따라 추가 입력사항이 있을 수 있으며 화이트리스트에 대한 제한을 할 수 있습니다. 플랫폼(웹, 서버, Android, iOS)을 올바르게 선택하지 않으면 API 사용에 장애가 발생할 수 있습니다. 화이트리스트에 대한 자세한 내용은 화이트리스트를 참고하세요.

API 키 추가

  1. Developers 콘솔로 이동합니다
  2. 좌측 사이드 메뉴에서 앱을 선택하거나 새로 만듭니다.
  3. 좌측 사이드 메뉴에서 해당 앱의 API 키 메뉴를 선택합니다.
  4. API 키 페이지에서 추가(+) 버튼을 선택 후, 용도에 맞는 플랫폼을 선택하고 화이트리스트를 추가하면, Key가 생성됩니다.

API 키 발급 개수는 앱 등급에 따라 제한될 수 있습니다.

API 키 삭제

앱의 소유자 및 개발자는 외부에 노출되거나 더 이상 사용하지 않는 API 키를 삭제할 수 있습니다. API 키를 삭제하면, 다시 복원할 수 없습니다. 프로젝트에서 사용중인 API 키라면, 다른 키로 변경해주세요.

화이트리스트

API 키를 추가할때 플랫폼 별 화이트리스트를 등록할 수 있습니다. 화이트리스트는 API 키가 유출되어도 다른 사용자가 같은 키를 이용하지 못하도록 막기 위해 등록합니다.

모든 플랫폼

모든 플랫폼 API 키 추가

화이트리스트의 제한 없이 어디서든 호출 가능한 API 키 입니다.

화이트리스트가 없는 API 키가 노출되면 다른 사용자가 해당 키를 사용할 수 있고, 많은 호출을 해서 Quota를 넘길 경우 사용자의 앱이 더이상 API를 호출하지 못하게 될 수 있습니다. 자신의 앱이 사용 가능한 Quota를 온전히 다 사용하려면 가능하면 화이트리스트를 등록해서 사용하고, 불가피하게 모든 플랫폼용 API 키를 사용하실때에는 API 키가 노출되지 않도록 주의하시기 바랍니다.

웹브라우저 - Referer

웹브라우저용 API 키 추가

웹 서비스나 웹 앱에 대한 URL(프로토콜 + 도메인)을 화이트리스트로 등록할 수 있습니다. 또한 줄바꿈으로 한 API 키에 여러개의 화이트리스트를 등록할 수 있습니다. 모든 URL은 도메인을 기준으로 그 서브 도메인을 포함하여 접근 허용됩니다.

whitelist 허용 도메인 예제
example.com protocol (ex>http://) 을 포함해야 합니다. -
http://www.example.com example.com의 서브도메인 example.com, www.example.com, a.example.com, b.a.example.com 등
http://example.com example.com의 서브도메인 example.com, www.example.com, a.example.com, b.a.example.com 등
http://a.example.com a.example.com의 서브도메인 a.example.com, b.a.example.com 등
http://www.example.com/test.php example.com의 서브도메인 example.com, www.example.com, a.example.com, b.a.example.com 등
http://a.example.com/test.php a.example.com의 서브도메인 a.example.com, b.a.example.com 등

서버 - IP

서버용 API 키 추가

서버 간 통신을 위해 특정 IP나 서브넷주소를 화이트리스트로 등록할 수 있습니다.

URL 패턴 설명
123.123.123.123 특정 IP만 접근을 허용합니다.
123.123.123.0/24 특정 대역의 IP만 접근을 허용합니다.

참고 : 사이더

모바일 - Bundle ID와 Package명

Android용 API 키 추가

iOS용 API 키 추가

Android의 경우 Package Name, iOS의 경우 Bundle ID를 화이트리스트로 등록할 수 있습니다.

Android 앱의 Package Name은 AndroidManifest.xml 파일 내 manifest 엘리먼트의 package 속성을 통해 알 수 있습니다

iOS 앱의 Bundle ID는 Info.plist 파일의 Bundle Identifier 프로퍼티에 설정됩니다. [[NSBundle mainBundle] bundleIdentifier] 메소드를 이용해도 Bundle ID 를 확인할 수 있습니다.

OAuth 2.0 설정

OAuth 2.0 설정 OAuth 2.0 설정 OAuth 2.0 설정 OAuth 2.0 설정

API 키 쿼터에서 OAuth Client를 발급받을 수 있습니다. 화이트리스트를 등록해야하며, callback url을 여러개 등록 가능합니다.

발급된 ClientID와 ClientSecret을 이용해 OAuth2.0 인증형 API를 사용할 수 있습니다.

API 쿼터

Developers 콘솔에서 제공하는 다양한 오픈 API에 대하여 사용자는 해당 앱의 등급이 할당된 최대 트래픽 한도에서 자유롭게 트래픽을 선택할 수 있습니다.

API 쿼터

API 카드

개발자 콘솔의 API 쿼터 메뉴의 제공되는 UI를 API 카드라고 합니다. 각 카드는 API 별로 분류되어 있으며 각 API 안에는 상세 API가 보여집니다. 각 상세 API는 이름과 1일 트래픽으로 화면상에 제공됩니다.

앱의 등급

개발자 콘솔에서는 소유자의 등급에 따라 앱 등급이 정해집니다. 즉, 소유자의 등급이 서비스라면 서비스의 등급에 할당된 최대 트래픽을 사용할 수 있습니다. 각 등급에 할당된 최대 트래픽양을 알고싶다면, API 카드의 서비스 등급을 눌러서 API 사용 트래픽을 늘려보세요.

트래픽 설정

앱을 생성하면 테스트 등급을 제공하지 않은 API를 제외하고 모든 API에 대한 테스트 등급이 활성화 됩니다. 또한, 현재 트래픽 선택을 변경 할 시 하단의 트래픽 그래프는 어제의 실제 트래픽이 반영된 그래프로 즉시 변경됩니다. 트래픽 변경을 원하는 사용자는 API 단위로 트래픽을 선택할 수 있습니다.

  1. Developers 콘솔로 이동합니다.
  2. 좌측 사이드메뉴에서 앱을 선택하거나 새로 만듭니다.
  3. 좌측 사이드 메뉴에서 해당 앱의 API 쿼터 메뉴를 선택합니다.
  4. 사용자가 변경하기를 원하는 API의 카드 안의 버튼을 클릭하여 원하는 트래픽을 설정합니다.

앱의 Owner의 등급에 따라 앱의 등급이 결정되고, 앱의 등급에 따라 사용 가능한 양이 결정됩니다.

테스트

테스트 등급은 앱의 등급이 테스트 등급 이상일 때 활성화 시킬 수 있습니다. 테스트의 등급은 사용자가 앱을 만들었을 때 (테스트를 제공하지 않은 API를 제외한) 모든 API에 활성화됩니다. 트래픽은 테스트용 앱에 적합한 트래픽으로 제공합니다.

서비스

서비스 등급은 앱의 등급이 서비스 등급 이상일 때 활성화 시킬 수 있습니다. 트래픽은 서비스용 앱에 적합한 트래픽을 제공하며, 실명인증된 개인회원만 이용할 수 있습니다. 따라서 소유자가 실명인증 되지 않은 테스트등급의 사용자라면, 실명 인증 페이지로 이동하여 인증 후 서비스 등급의 트래픽을 이용할 수 있습니다.

비즈니스

비즈니스 등급은 앱의 등급이 비즈니스 등급 이상일 때 활성화 시킬 수 있습니다. 트래픽은 비즈니스 앱에 적합한 트래픽을 제공하며, 법인 인증된 기업 회원만 이용할 수 있습니다. 따라서 소유자가 Daum 법인 회원 ID로 로그인하지 않은 사용자라면, 법인 계정 발급 페이지로 이동하여 법인 계정을 발급받아야 하며 이후 법인 계정으로 로그인해야 비즈니스 등급의 트래픽을 이용할 수 있습니다.

제휴신청

제휴신청 버튼을 누르면 개발자 콘솔의 제휴센터로 이동하게 됩니다. 제휴센터에서 제휴 담당자와 상담 후 제휴용 트래픽을 사용할 수 있습니다. 법인 인증된 기업 회원만 이용할 수 있습니다.