이 문서는 애플리케이션(이하 앱) 정보를 안내합니다.
앱 이름, 아이콘, 회사명으로 구성됩니다. [내 애플리케이션] > [일반] > [기본 정보] 메뉴에서 수정 가능합니다.
기본 정보는 아래 이미지와 같이 카카오 로그인 동의 화면, 연결된 서비스 관리, 카카오톡 메시지 하단의 출처 등에 표시됩니다. 사용자가 서비스 정보 확인 후 안심하고 이용할 수 있도록, 앱 기본 정보를 실제 서비스와 동일하게 입력해야 합니다.
카카오 API 요청 시 인증을 위해 필요합니다. 앱 키는 [내 애플리케이션] > [요약 정보] 또는 [내 애플리케이션] > [앱 키]에서 확인할 수 있습니다.
앱 키는 플랫폼별로 각각 발급됩니다. 플랫폼에 맞지 않는 앱 키를 사용하면 에러 응답을 반환합니다.
앱 키가 노출되었을 경우, 오너(OWNER)가 앱 키를 재발급할 수 있습니다. 한 번 키가 재발급되면 이전으로 되돌릴 수 없으니 주의합니다. 앱 키 재발급 시, 서비스 애플리케이션이나 웹 사이트에 적용된 앱 키를 재발급된 값으로 변경해야 합니다.
카카오 API는 카카오디벨로퍼스에 플랫폼 정보가 등록된 서비스에서만 사용 가능합니다. [내 애플리케이션] > [플랫폼]에서 서비스의 각 플랫폼 정보를 등록할 수 있습니다.
앱에 등록된 플랫폼 정보가 실제 서비스와 다르면 invalid android_key_hash or ios_bundle_id or web_site_url
에러가 발생합니다. 아래는 해당 에러 발생 시 플랫폼별로 확인해야 할 사항입니다.
package
속성 값과 동일한지, 키 해시 값이 등록되어 있는지 확인[플랫폼]에 등록된 오픈마켓 URL입니다. 카카오톡 공유나 메시지 API로 전송된 메시지는 서비스 앱 실행이 가능한 링크를 제공합니다. 서비스 앱 실행 시 사용자 기기에 해당 앱이 설치되어 있지 않을 경우, 등록된 마켓 URL로 이동합니다.
🅐 패키지명(Package Name)
package
속성 값 입력🅑 마켓 URL(Market URL)
🅒 키 해시(Key hash)
🅐 번들 ID(Bundle ID)
🅑 앱스토어 ID(Appstore ID) 및 마켓 URL(Market URL)
🅐 사이트 도메인
http://
, https://
, file://
형식의 도메인 등록http
와 https
도메인은 둘 중 한 가지만 등록해도 사용 가능🅑 기본 도메인
비즈 앱은 서브 도메인과 카카오 로그인 Redirect URI에 와일드카드 문자를 포함한 URI를 등록할 수 있습니다. 와일드카드 문자를 포함한 서브 도메인 사용 시, 아래 규칙을 준수해야 합니다.
팀은 앱 접근 권한을 관리하는 체계입니다. 앱의 개발 구성원인 팀원으로 등록된 개발자 계정만이 앱 정보를 조회 또는 수정할 수 있습니다. 테스트 앱의 경우, 팀원만 카카오 API 호출이 가능합니다.
🅐 팀원 초대
🅑 팀원 정보 및 관리
앱 소유자인 개발자 계정을 알 수 없다면 FAQ를 참고합니다.
서비스를 소유한 사업자 정보를 등록한 앱입니다.
비즈 앱은 아래와 같은 추가 기능을 이용할 수 있습니다.
[내 애플리케이션] > [비즈니스] > [사업자 정보 등록]을 눌러 사업자등록번호를 입력합니다. 오너만 비즈 앱 전환이 가능합니다.
사업자등록번호가 없는 개인이나 단체가 제공하는 서비스의 앱도 아래 조건 만족 시 [내 애플리케이션] > [비즈니스] > [개인 개발자 비즈 앱]에서 비즈 앱 전환이 가능합니다.
개인 개발자 비즈 앱은 사업자 정보가 없어 비즈니스 채널 연결이 불가능합니다. 카카오싱크 도입이 필요한 경우, 비즈니스 채널 연결을 위해 사업자 정보를 등록해야 합니다. 개인 개발자 비즈 앱 전환 후에도 [내 애플리케이션] > [비즈니스]에서 사업자 정보를 등록할 수 있습니다.
테스트 앱(테스트 애플리케이션)은 실제 서비스에 사용 중인 앱에 영향을 미치지 않고 신규 기능이나 업데이트를 개발할 때 사용합니다. 원본 앱이 가진 권한과 테스트 앱용으로 기본 제공하는 권한을 검수 신청 전에 함께 활용할 수 있습니다. 실제 서비스 적용 시에는 테스트 앱이 아닌 원본 앱의 앱 키를 사용해야 합니다.
테스트 앱은 비즈 앱에만 제공되는 기능으로, 한 원본 앱당 최대 5개까지 생성 가능합니다.
테스트 앱이 제공하는 주요 기능입니다.
[내 애플리케이션] > [일반] > [테스트 앱 정보]에서 [테스트앱 생성]을 선택해 생성합니다.
[테스트 앱 정보]의 [테스트 앱] 항목에서 생성한 테스트 앱을 확인할 수 있습니다. 테스트 앱의 이름을 선택하면 설정 화면으로 이동합니다.
원본 앱과 다른 별도의 앱 키, 독립된 설정값, 테스트 앱용 권한을 사용할 수 있습니다.
테스트 앱 사용 시 고려해야 할 제한 사항입니다.
테스트 앱이 실제 서비스에 적용되지 않도록 주의합니다. 테스트 앱은 테스트 목적으로만 제공하는 기능으로 별도의 쿼터 제한이 있습니다. 테스트 이외의 목적으로 사용 시 제재됩니다.
테스트 앱에 기본 제공하는 전체 권한 목록입니다. 테스트 앱용으로 제공하는 추가 권한을 원본 앱에서 사용하려면, 별도 검수 신청 후 권한을 획득해야 합니다.
앱의 기본 기능 및 권한
개인정보 동의 항목의 사용자 정보 제공 동의 단계(필수 또는 선택 동의 권한 추가 제공)
account_email
): 필수 동의name
): 선택 동의, 필수 동의gender
): 필수 동의age_range
) 필수 동의birthday
): 필수 동의birthyear
): 선택 동의, 필수 동의phone_number
): 선택 동의, 필수 동의shipping_address
): 선택 동의, 필수 동의