권한

이 문서는 카카오 API 플랫폼의 권한 체계에 대해 안내합니다.

기능 소개

권한은 카카오 API의 특정 기능을 사용하기 위해 필요한 앱의 자격입니다. 특정 API 호출을 포함해 엄격한 관리와 보호가 필요한 개인정보 활용, 설정 항목에도 권한이 필요할 수 있습니다.

카카오 API 플랫폼의 제공 권한 목록은 권한 목록에서, 권한 신청 방법은 권한 신청 방법에서 확인할 수 있습니다.

권한으로 인한 에러

권한이 필요한 API를 권한 없이 요청해 실패한 경우에는 에러 코드 -5와 함께 에러 메시지를 받습니다. 아래 예제를 참고합니다.

HTTP/1.1 403 Forbidden
{
    "msg":"permission denied",
    "code":-5
}

권한 종류

앱 타입별 권한

앱 타입에 따라 권한이 부여되어 전용 추가 기능을 제공합니다. 앱 타입별 자세한 내용은 아래 각 항목의 링크를 참고합니다.

• 비즈 앱: 서비스 사업자 정보를 등록한 앱
• 테스트 앱: 테스트 용도로 추가 제공하는 앱, 원본 앱의 권한에 더해 테스트 앱 전용 권한 제공

사용 권한

앱에서 사용자 정보 또는 추가 기능을 사용하기 위해 필요한 권한입니다. 권한에 따라 앱 권한 신청 또는 일반 신청으로 부여받을 수 있습니다.

권한 신청 방법

카카오 API 플랫폼의 권한은 아래 방법으로 신청할 수 있습니다.

앱 권한 신청

카카오 API 플랫폼에서 제공하는 권한 심사 및 부여 시스템인 앱 권한 신청에서 신청합니다. 앱 권한 신청 대상에서 신청 가능 목록을 확인할 수 있습니다.

일반 신청

각 개발 문서의 [이해하기] > [이용 정책] 내용을 참고해 해당 방법에 따라 신청합니다. 일반 신청 대상에서 신청 가능 목록을 확인할 수 있습니다.

권한 목록

앱 권한 신청 대상

앱 권한 신청으로 심사 승인 후 제공받을 수 있는 권한 목록입니다. 권한별 안내, 심사 승인 기준, 주의 사항을 함께 확인합니다.

권한	설명
카카오톡 공유 쿼터	카카오톡 공유의 일 제공 쿼터 한도 상향(참고: 카카오톡 공유, 쿼터) 승인 기준 상향된 쿼터의 사용 목적이 카카오의 운영 정책에 부합해야 합니다.
개인정보 동의항목	카카오 로그인과 카카오싱크에서 제공하는 개인정보의 추가 수집 기능(참고: 개인정보 동의항목) 승인 기준 신청 앱의 운영 주체 및 사용 목적이 카카오의 운영 정책에 부합해야 합니다. 주의 사항 카카오싱크의 기능은 회원 가입에 필요한 사용자의 개인정보와 약관에 대한 동의 전달에 한정되며, 기능 사용과 관련된 모든 책임은 신청 앱의 운영 주체에 있습니다.
카카오톡 친구 목록 / 메시지	카카오톡 소셜 API와 피커, 카카오톡 메시지 API(참고: 카카오톡 소셜, 카카오톡 메시지) 승인 기준 신청 앱의 운영 주체 및 사용 목적이 카카오의 운영 정책에 부합해야 합니다.
톡캘린더	톡캘린더 API, 공개 일정, 구독 캘린더, 할 일(참고: 톡캘린더) 승인 기준 신청 앱의 운영 주체 및 사용 목적이 카카오의 운영 정책에 부합해야 합니다.
카카오맵	카카오맵 API 활성화 앱을 소유한 오너 또는 개발자의 추가 카카오맵 API 활성화(참고: 지도, 로컬) 승인 기준 신청 앱의 운영 주체 및 사용 목적이 카카오의 운영 정책에 부합해야 합니다. 주의 사항: 카카오맵 API의 추가 활성화는 에러, 오설정, 무료 쿼터 소진 방지를 위해 앱 권한 신청 및 승인이 필요합니다. 동일 서비스 내 중복 신청 또는 내부 검토 결과(관계법령, 서비스약관, 운영정책 등)로 인해 권한 승인이 거절될 수 있습니다.
멀티 앱	하나의 앱에 여러 개의 네이티브 앱 패키지 이름, 번들 ID를 등록하기 위한 추가 기능(참고: 고급: 멀티 앱) 승인 기준 신청 앱의 운영 주체 및 사용 목적이 카카오의 운영 정책에 부합해야 합니다.
카카오모먼트	카카오모먼트 광고 관련 설정을 조회하고 관리할 수 있는 API 승인 기준 신청 앱의 운영 주체 및 사용 목적이 카카오의 운영 정책에 부합해야 합니다. 비고 2024년 5월 8일 이전의 권한 신청 건에 대한 심사 결과는 데브톡으로 문의하여 확인 가능
카카오톡 채널 연결	비즈니스 채널 관련 기능을 사용하기 위한 앱과 카카오톡 채널 연결(참고: 카카오톡 채널, 카카오톡 채널 연결) 승인 기준 카카오톡 채널 관련 기능의 사용 목적이 카카오의 운영 정책에 부합해야 합니다.

일반 신청 대상

각 개발 문서의 [이해하기] > [이용 정책] 내용을 참고해 별도로 신청해야 하는 권한 목록입니다.

권한	기능
쿼터 한도 상향	앱 권한 신청 대상 이외 제품의 쿼터 한도 상향