본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트

사이드 메뉴

오픈 문서

시작하기

카카오디벨로퍼스

로그인

커뮤니케이션

인공지능

플랫폼 API

API 제공

전용 API

어드민 API

더 보기

이용 안내

권한

이 문서는 카카오 또는 공동체 서비스의 카카오디벨로퍼스 권한 체계를 안내합니다.

기능 소개

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

카카오디벨로퍼스 권한 신청 방법은 권한 신청 방법에서 확인할 수 있습니다.

참고: 권한으로 인한 에러

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

// HTTP/1.1 403 Forbidden

{

  "msg": "permission denied",

  "code": -5

}

권한 신청 방법

카카오 또는 공동체 서비스의 카카오디벨로퍼스 권한은 아래 과정으로 신청할 수 있습니다.

  1. 앱 타입에 따라 권한의 기본 제공 및 획득 가능 여부가 상이합니다. 앱 타입 설정 방법은 앱 타입 설정을 참고합니다.
  2. 아래 분류별 권한 신청 필요 항목에서 필요한 권한을 확인합니다.
    • 기능: 앱 설정, 제품 추가 기능 사용 권한
    • API: API별 요청, 응답, 동의항목 설정, 기능 사용 권한
  3. [서비스] API플랫폼 아지트에서 필요한 권한을 신청합니다.

권한 종류

카카오 또는 공동체 서비스의 카카오디벨로퍼스 권한 종류입니다.

이름설명
기능 사용 권한앱 또는 제품의 전체 또는 일부 기능을 사용하기 위해 필요한 권한
일부 API는 관련 기능 사용 권한이 있어야 요청 가능
API 사용 권한특정 API를 호출하기 위해 필요한 권한
API 응답 권한API 응답 중 특정 정보를 제공 받기 위한 권한
동의항목 설정 권한앱에 특정 동의항목을 설정하기 위해 필요한 권한
일부 API는 관련 동의항목을 설정하고 사용자 동의를 받은 후 호출 가능

권한 신청 필요 항목: 기능

앱 설정

권한 신청 후에 사용할 수 있는 앱 설정 기능 목록입니다.

Inhouse
: 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요
기능설명
앱 키 생성 개수 상향권한 코드: INCREASED_APP_KEY_COUNT
플랫폼 키 / 어드민 키의 타입별 생성 가능한 앱 키 개수를 상향 조정
그룹 앱권한 코드: GROUP_APP_SUPPORTED
하나의 앱 정보에 여러 앱을 그룹으로 묶어 서로 사용자 연결 정보 공유 가능(예: 통합 멤버십)
사용자 ID 고정 비활성화권한 코드: USER_MANAGEMENT_KEEP_USER_ID
사용자 ID 고정 비활성화 가능
1회성 제공 동의권한 코드: PLUGIN_SUPPORTED
1회성 제공 동의(OTP) 사용 가능
계정 상태 변경 웹훅의 추가 카테고리
Inhouse
권한 코드: OIDC_SSE_SUPPORTED
계정 상태 변경 웹훅의 CAEP, RISC 카테고리 사용 가능
만 14세 미만 사용자 로그인 차단권한 코드: UPDATE_NOT_ALLOWED_UNDER_AGE14
만 14세 미만인 사용자의 카카오 로그인 차단 기능 사용 가능
기능 적용 시, 만 14세 미만 카카오계정에 "만 14세 미만은 이용하실 수 없습니다" 안내 화면 출력
연결된 서비스 숨김권한 코드: USER_MANAGEMENT_HIDDEN_CONNECTED_APPS
연결된 서비스 관리에서 서비스와 앱의 연결 상태 숨김 허용
회원 관리를 별도로 하지 않는 서비스(가입 또는 탈퇴 절차 없음)에 한해 사용 가능하며, 사용자가 서비스 이용 중임을 알 수 없고 계정 탈퇴 시 탈퇴 불가 사유 API를 호출하지 않음

카카오톡 공유 / 카카오톡 메시지

권한 신청 후에 사용할 수 있는 카카오톡 공유와 카카오톡 메시지 기능 목록입니다.

메시지 템플릿 설정 권한

[도구] > [메시지 템플릿]의 설정별 필요한 권한 정보는 메시지 템플릿 도구에서 확인할 수 있습니다.


Inhouse
: 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요
Review
: 카카오톡팀과 협의 후 제공
기능설명
KAGE 외 이미지 지원
Inhouse
권한 코드: NONE_KAGE_IMAGE_SUPPORTED
image_url에 KAGE 이미지 URL이 아닌 URL 할당 가능
멀티 버튼 지원권한 코드: MULTI_BUTTON_SUPPORTED
버튼 3개 이상 사용 가능

설정 경로: [도구] > [메시지 템플릿] > [버튼]
텍스트 길이 제한 해제
Review
권한 코드: FREE_TEXT_SUPPORTED
메시지의 텍스트의 길이 제한(제목과 설명 각각 2줄) 해제

중요: 권한 요청 시 말풍선 시안 첨부 필요
참고: API 4.0 말풍선 (레버리지 말풍선) 긴 텍스트(FT) 사용 관련 체크

설정 경로: [도구] > [메시지 템플릿] > [제목/설명] > [길이 제한 해제]
미등록 도메인 허용권한 코드: DOMAIN_CHECK_PASS
앱 관리 페이지의 [앱] > [제품 링크 관리] > [웹 도메인]에 등록된 도메인과 일치하지 않는 도메인의 URL을 웹 링크에 사용 가능

중요: 보안팀 요청에 따라, 도메인을 특정할 수 없는 서비스만 제공
참고: 메시지 템플릿의 웹도메인 권한 회수 안내

설정 경로: [도구] > [메시지 템플릿] > [컴포넌트 링크 관리]
카카오 인증 마크
Review
권한 코드: KAKAO_VERIFIED
수신자의 메시지 말풍선에 카카오 인증 마크 무조건 부착

중요: 송금 등 일부 유형의 메시지에만 사용 가능
카카오 인증 마크 선택 적용
Review
권한 코드: KAKAO_VERIFIED_SUPPORTED
수신자의 메시지 말풍선에 카카오 인증 마크 적용 여부를 메시지 템플릿 도구에서 선택 가능

중요: 송금 등 일부 유형의 메시지에만 사용 가능

설정 경로: [도구] > [메시지 템플릿] > [공통 설정] > [카카오 인증마크]
말풍선 링크: 카카오톡 세션 전달
Review
권한 코드: AUTH_SUPPORTED
링크에 카카오톡 세션 전달

참고: 말풍선 공장 > 레버리지 말풍선 > 필드 정의 > LAA
말풍선 링크: 다이얼로그(Dialog) 지원
Review
권한 코드: DIALOG_SUPPORTED
링크 선택 시 다이얼로그 메시지를 표시할 수 있도록 설정 가능

중요: 다이얼로그는 모바일만 지원하며, 문구 개별 설정 불가
참고: 말풍선 공장 > 레버리지 말풍선 > 필드 정의 > LAD
말풍선 링크: 외부 브라우저 지원
Review
권한 코드: WEB_ACTION_TYPE_SUPPORTED
링크 선택 시 외부 브라우저로 이동 가능하도록 설정 가능

참고: 말풍선 공장 > 레버리지 말풍선 > 필드 정의 > LAT
말풍선 링크: 카카오톡 페이지 지원
Review
권한 코드: PAGE_SUPPORTED
링크 선택 시 카카오톡 내 특정 페이지로 이동하도록 설정 가능

참고: 말풍선 공장 > 레버리지 말풍선 > 필드 정의 > LAT
DID 지원
Inhouse
권한 코드: DID_SUPPORTED
문서 ID(DID) 직접 입력 가능
문서 ID는 서비스 내 특정 문서를 지칭하는 값으로, 메시지에 노출되지 않으며 카카오톡 공유 콘텐츠의 통계 산출 용도로 사용(URL 사용 권장, URL이 없는 경우 고유한 ID 지정 가능)

설정 경로: [도구] > [메시지 템플릿] > [공통 설정] > [문서 아이디]
음악 말풍선 지원(멜론 전용)
Review
권한 코드: MUSIC_TYPE_SUPPORTED
음악(Music) 말풍선 허용

카카오톡 채널

권한 신청 후에 사용할 수 있는 카카오톡 채널 기능 목록입니다.

Inhouse
: 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요
Review
: 별도의 사용 협의 후 제공
이름설명
미연결 채널 접근 허용
Review
PLUS_FRIENDS_CHECK_PASS
앱과 카카오톡 채널의 연결 여부와 상관없이 모든 채널을 대상으로 카카오톡 채널 API 호출 가능

문자 메시지

권한 신청 필요 항목: API

권한 신청이 필요한 API별 권한 목록입니다. 각 권한의 기본 제공 여부와 신청 가능 여부는 앱 타입에 따라 상이합니다. 별도 표시가 없는 항목은 모든 앱 타입이 신청해야 하는 권한입니다.

카카오 로그인

APIAPI 사용 권한API 응답 권한동의항목 설정 권한기능 사용 권한
액세스 토큰 정보 조회----
연령인증 정보 조회--
  • CI(연계정보)*
-
서비스 약관 선택해 동의 요청---서비스 약관
채널 선택해 동의 요청--
  • 카카오톡 채널 추가 상태 및 내역*
앱에 카카오톡 채널 연결*
서비스 약관 동의 내역 조회필요--서비스 약관
서비스 약관 동의 철회필요--서비스 약관
고급: 동의항목 동의 처리필요*---
고급: 서비스 약관에 동의필요--서비스 약관
싱크 플러그인---싱크 플러그인 ID 발급
* 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요 ** 인하우스 앱만 신청 가능, 이외 앱은 권한 신청 불가

사용자 정보

APIAPI 사용 권한API 응답 권한동의항목 설정 권한기능 사용 권한
사용자 정보 조회--
배송지 조회필요*-
  • 배송지 정보*
-
사용자 ID 조회필요*
  • 카카오톡회원번호*
  • 제재 또는 휴면 상태의 카카오계정 정보
--
그룹 내 사용자 정보 조회---그룹 앱
그룹 사용자 토큰 생성필요--그룹 앱
카카오계정 상태 조회-
  • 카카오계정 ID
  • 카카오계정 스팸 의심 상태 여부
  • 카카오계정 휴면 상태 여부
  • 카카오계정 제재 상태 여부
--
연결된 앱 정보 조회필요*
  • 카카오톡회원번호
--
앱 연결 이력 조회필요*---
카카오계정 검색--
  • 이메일*
  • 전화번호*
-
앱에 연결된 카카오계정 휴면 방지----
앱과 사용자 인증필요
  • 카카오톡회원번호
--
회원번호 사전 발급서비스 앱과 플랫폼 앱 모두 권한 필요---
공동체 앱: 사용자 분석 데이터 조회필요*-
  • 서비스 이용내역으로 추정한 정보(연령대, 성별)*
  • 서비스 이용내역으로 추정한 정보(관심사)*
-
공동체 앱: 본인인증 정보 등록 가능 여부 조회필요*---
공동체 앱: 카카오계정에 본인인증 정보 등록필요*---
공동체 앱: 카카오계정에서 본인인증 정보 삭제필요*---
공동체 앱: 카카오계정과 본인인증 정보 비교필요*---
* 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요 ** 인하우스 앱만 신청 가능, 이외 앱은 권한 신청 불가

카카오 소셜

APIAPI 사용 권한API 응답 권한동의항목 설정 권한기능 사용 권한
사용자 목록으로 카카오톡 프로필 조회-
  • 카카오톡회원번호
  • 카카오계정 ID**
--
피커: 친구 선택---
피커: 채팅방 선택--
  • 카카오톡 챗방 목록*
-
피커: 채팅방 멤버 선택-
  • 카카오톡 챗방 목록*
-
피커: 친구 또는 채팅방 선택-
  • 카카오톡 챗방 목록*
-
피커: 친구 또는 채팅방 멤버 선택-
  • 카카오톡 챗방 목록*
-
카카오톡 친구 목록 조회-
  • 카카오톡회원번호
--
읽지 않은 채팅방 목록 조회필요*
  • 1:1 채팅방의 상대방 카카오톡 회원번호**
  • 카카오톡 챗방 목록*
-
인하우스 앱: 카카오톡 친구 목록 조회(배치)필요**---
인하우스 앱: 채팅방 목록 조회-
  • 1:1 채팅방의 상대방 카카오톡 회원번호**
--
인하우스 앱: 채팅방 정보 조회-
  • 1:1 채팅방의 상대방 카카오톡 회원번호**
--
멜론: 카카오톡 프로필 뮤직에 곡 추가멜론, 헤이카카오 전용---
* 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요 ** 인하우스 앱만 신청 가능, 이외 앱은 권한 신청 불가

카카오톡 메시지

APIAPI 사용 권한API 응답 권한동의항목 설정 권한기능 사용 권한
기본 템플릿으로 메시지 발송필요*---
사용자 정의 템플릿으로 메시지 발송필요*---
스크랩 메시지 발송필요*---
플레인 메시지 발송필요---
초대 프로필 공개 상태 조회필요---
프로필 공개 상태 조회필요---
* 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요 ** 인하우스 앱만 신청 가능, 이외 앱은 권한 신청 불가

카카오톡 오픈채팅

  • API 사용 권한
    • 인하우스 앱, 공동체 앱: 별도 협의 후 사용 권한 획득 가능, 이용 정책 참고

카카오톡 채널

APIAPI 사용 권한API 응답 권한동의항목 설정 권한기능 사용 권한
카카오톡 채널 프로필 조회필요*---
카카오톡 채널 관계 조회-
  • 카카오톡회원번호
  • 카카오톡 채널 추가 상태 및 내역*
-
여러 사용자 카카오톡 채널 관계 조회-
  • 카카오톡회원번호
  • 카카오톡 채널 추가 상태 및 내역*
-
카카오톡 채널 친구 추가필요*
  • 카카오톡회원번호
--
* 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요 ** 인하우스 앱만 신청 가능, 이외 앱은 권한 신청 불가

카카오톡 채널 메시지

  • API 사용 권한

톡캘린더

문자 메시지

문자 메시지 발송
문자 메시지 수신

음성

앱

APIAPI 사용 권한API 응답 권한동의항목 설정 권한기능 사용 권한
앱 상세 정보 조회-
  • 대상 앱에 대한 앱 키 조회 권한
  • 회원가입 플러그인 권한
--
플러그인 설정 조회플랫폼 앱에 권한 필요--공통플러그인(싱크 플러그인, 위치 플러그인)
* 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요 ** 인하우스 앱만 신청 가능, 이외 앱은 권한 신청 불가

특정 서비스를 위한 API

APIAPI 사용 권한API 응답 권한동의항목 설정 권한기능 사용 권한
카카오페이: 사용자 통계 조회카카오페이 전용-
  • 최근 90일의 카카오 서비스 이용 통계 정보(서비스별 접속 일수)
  • 최근 90일의 카카오 서비스 결제 관련 통계 정보(결제 횟수, 결제 금액 합계, 결제 일수)
-
카카오뱅크: 카카오 선물하기 서비스 이용 내역 조회카카오뱅크 전용---
카카오뱅크: 카카오T 서비스 이용 내역 조회카카오뱅크 전용---
싱크 플러그인: 회원 가입 완료 처리싱크 플러그인 전용--서비스 약관
* 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요 ** 인하우스 앱만 신청 가능, 이외 앱은 권한 신청 불가

API 제공을 위한 API 플랫폼 연동

APIAPI 사용 권한API 응답 권한동의항목 설정 권한기능 사용 권한
패시브 연동필요*---
* 인하우스 앱은 기본 제공, 공동체 앱만 권한 신청 필요 ** 인하우스 앱만 신청 가능, 이외 앱은 권한 신청 불가

도움이 되었나요?