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

kakao developers

관련사이트

사이드 메뉴

플랫폼 API

API 제공

전용 API

어드민 API

이 문서는 카카오 또는 공동체 서비스용 REST API 규격 정보를 안내합니다.

이 문서는 카카오 및 공동체에 적용되는 인증 방식KA 헤더 정보를 안내합니다. 기본적인 요청 규격에 대한 정보는 요청시작하기를 참고합니다.

카카오 API 서버는 올바른 요청인지 검증하기 위해 헤더(Header)로 특정 인증 정보를 전달 받습니다. 앱 키나 사용자의 토큰과 같은 인증 정보를 사용합니다. 각 API의 개발 문서의 헤더 정보에서 지원되는 인증 정보의 종류를 확인할 수 있습니다. 아래는 주요 인증 정보의 종류입니다.

이름형식설명
액세스 토큰 방식Authorization: Bearer ${ACCESS_TOKEN}서비스 앱에서 액세스 토큰으로 요청합니다.
서비스 앱 어드민 키 방식Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}서비스 앱에서 어드민 키와 사용자 ID로 요청합니다.
위임 방식Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}내부 API 요청 시 사용 가능합니다. 서비스 앱 대신 위임(Delegation) 받은 플랫폼 앱이 대신 요청합니다.
서비스 앱 어드민 키가 아닌 플랫폼 앱 어드민 키를 사용합니다. 서비스 앱의 앱 ID, 앱 키, 토큰 중 하나를 파라미터로 전달해 대상을 명시해야 합니다.
OTP 토큰 방식Authorization: OTP ${OTP_TOKEN}서비스 앱에서 1회성 제공 동의로 발급받은 OTP 토큰으로 요청합니다.
OTP 위임 방식Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}
target_otp_token=${OTP_TOKEN}
내부 API 요청 시 사용 가능합니다. 위임 받은 플랫폼 앱이 서비스 앱을 대신해 요청합니다.
서비스 앱의 OTP 토큰을 파라미터로 전달해 API 호출 대상과 사용자의 1회성 제공 동의 정보를 확인합니다.

위임 방식은 플랫폼 앱(카카오 또는 허가받은 공동체의 앱)이 서비스 앱(실제 API를 활용할 서비스의 앱)을 대신해 카카오 API를 호출하는 방식입니다. (예: 카카오게임의 지니 앱이 위임 방식으로 각 카카오게임 앱 대신 카카오 API 호출)

위임 방식 API 요청의 인증은 아래 기준으로 플랫폼 앱과 서비스 앱에 대해 각각 수행합니다.

  • 플랫폼 앱: 플랫폼 앱 어드민 키
  • 서비스 앱: API별 지원 인증 방식 상이, 각 개발 문서 내용 확인 필요

모든 어드민 키사용 가능 API에 호출 허용 설정을 한 API만 요청 가능합니다. 서비스 앱의 인증 방식도 어드민 키를 사용(target_app_key에 서비스 앱의 어드민 키 지정)하는 경우, 서비스 앱의 어드민 키에도 요청 API에 대한 호출 허용 설정이 필요합니다. (참고: 사용 가능 API로 지정하지 않은 API 호출 시 발생 에러)

위임 방식 사용 시 주의 사항

서비스는 직접 요청하지 않은 API 호출이 발생할 수 있음을 인지하고, 사용자가 동의한 개인정보와 접근 권한을 다른 용도로 사용하지 않도록 관리해야 합니다. 플랫폼 앱이 서비스 앱의 개인정보를 사용하려면 별도 협의를 거치거나 사용자 동의를 받아야 합니다. 단, 인하우스 앱 간 위임 방식은 카카오 내부 정보 처리에 해당해 별도 절차가 필요 없습니다.

일부 API는 요청 시 사용자 환경 정보를 담은 KA(Kakao Agent) 헤더를 함께 전달해야 합니다. 카카오 SDK 사용 시, SDK에서 KA 헤더가 추출되어 전달됩니다. 카카오 SDK를 임베디드(Embeded)해서 사용하는 경우, SDK 모듈로 KA 헤더를 추출해야 합니다.

KA 헤더의 각 구성 요소는 API별 필수 여부에 따라 선택적으로 전달 가능하고, 이밖에 newtone-sdk/x.x.x와 같이 키/값 형식으로 추가 정보를 전달할 수 있습니다. 기본 구성 요소는 아래를 참고합니다.

이름설명예제
sdk사용하는 카카오 SDK 버전sdk/1.0.47
sdk_typeAndroid SDK 또는 iOS SDK 사용 시 Rx 버전 여부sdk_type/swift
sdk_type/kotlin
os사용자 기기(Client)의 OS 버전os/ios-8.3
os/android-19
os/javascript
lang사용자 언어 정보, 언어-국가코드 형식으로 Java의 Locale 규격을 따름

참고: ISO-3166 Country Codes and ISO-639 Language Codes
lang/ko-KR
res해상도 정보res/320x568
device사용자 기기의 기종device/iPhone
device/LG-F240S
device/Linux_armv7l
originAndroid key hash, iOS Bundle ID, JavaScript referer와 같은 유효성 검증을 위한 정보origin/com.beatpacking.Beat
origin/Qm7e1b/eHr14u31lGLoJX8oR5NE=
origin/http%3A%2F%2Fwww.nytimes.com
android_pkg안드로이드 패키지 이름android_pkg/net.daum.android.daum
ipKA 헤더가 필수인 API는 REST API 요청 시 IP 정보 전달ip/xxx.xx.xx.xxx
sdk/${SDK_VERSION} sdk_type/${SDK_TYPE} os/${PLATFORM_OS_VERSION} lang/${LANGUAGE} res/${RESOLUTION} device/${DEVICE_INFO} origin/${ANDROID_KEY_HASH OR IOS_BUNDLE_ID OR CLIENT_ORIGIN} android_pkg/${PACKAGE_NAME}
sdk/1.0.47 sdk_type/kotlin os/android-19 lang/ko-KR device/LG-F240S origin/Qm7e1b/eHr14u31lGLoJX8oR5NE= android_pkg/net.daum.android.daum
sdk/1.0.32 sdk_type/swift os/ios-8.3 lang/ko-KR res/320x568 device/iPhone origin/com.beatpacking.Beat
sdk/1.0.22 os/javascript lang/en-GB device/Linux_armv7l origin/http%3A%2F%2Fwww.nytimes.com
ip/xxx.xx.xx.xxx

카카오 API는 공통 응답 포맷에 맞춰 구성된 응답을 제공합니다. 공통 응답 포맷은 API 요청의 응답을 일정한 코드(Code)와 형식으로 반환하도록 규정한 형식입니다. 자세한 정보는 응답을 참고합니다.

이 문서는 KAPI(kapi.kakao.com) 요청의 응답에 대해 다루며, KAUTH(kauth.kakao.com) API 요청의 응답 정보는 에러 코드에서 확인할 수 있습니다.

카카오 API 요청 응답으로 받는 에러 코드 및 예외 정보입니다.

이 문서는 인하우스 및 제휴 API에서만 발생하는 에러 응답에 대해 안내합니다. 이 문서에 포함되어 있지 않은 항목은 에러 코드에서 확인할 수 있습니다.

에러 코드설명HTTP 상태 코드
-405RequiredAgeVerificationException
앱에 강제 연령인증(eager) 설정이 되어 있고, 설정된 조건을 만족하지 않는 사용자를 대상으로 요청한 경우
해결 방법: 연령인증 페이지 호출로 연령인증 요청, 카카오 SDK 사용 시 강제 연령인증 방식을 사용하는 앱은 SDK가 RequiredAgeVerificationException 에러 발생 시 내부적으로 연령인증 페이지 호출을 대신 수행
참고: 연령인증
401
-406UnderAgeLimitException
앱 설정의 제한 연령 이하임이 확인된 사용자가 요청한 경우
해결 방법: 사용자에게 제한 연령에 맞지 않는다는 문구로 안내
참고: 연령인증
401
-409RequiredParentAgreementException
동의항목 동의 처리 요청 시 보호자동의 토큰을 확인할 수 없는 경우, 사용자가 14세 미만인 경우 보호자동의 필요
401
에러 코드설명HTTP 상태 코드
-410MismatchedAuthInfoException
카카오계정의 본인인증 정보와 공동체의 본인인증 정보가 일치하지 않아 등록할 수 없는 경우
400
에러 코드설명HTTP 상태 코드
-504NotSupportedOsException
지원하지 않는 기기로 메시지를 보내는 경우
400
-531특정 앱에서 보내는 이가 특정인에게 한 달 동안 보낼 수 있는 쿼터를 초과한 경우400
-534특정 앱에서 받는 이가 한 달 동안 받을 수 있는 쿼터를 초과한 경우400
에러 코드설명HTTP 상태 코드
-505MaxPlusFriendsLimitException
카카오톡 채널 친구 추가 요청 시, 사용자가 추가 가능한 카카오톡 채널 수 한도(1000개)에 도달한 상태여서 요청이 실패한 경우
400
에러 코드설명HTTP 상태 코드
-530받는 이가 발송 채널의 친구가 아닌 경우400
-537야간 시간(대한민국 표준시 기준, 20시 55분 ~ 다음날 08시)에 광고성 메시지 전송을 시도한 경우(국내 사용자만 해당)400
에러 코드설명HTTP 상태 코드
-999JSON 직렬화에 실패했거나, 내부 서버 에러가 발생한 경우500
에러 코드설명HTTP 상태 코드
-821KakaoGiftException
카카오뱅크: 카카오 선물하기 서비스 이용 내역 조회 호출 시 카카오 선물하기 데이터 API 서버 에러
400
-822KakaoMobilityException
카카오뱅크: 카카오T 서비스 이용 내역 조회 요청 시, 카카오 택시 데이터 API 서버 에러
400
URL호스트메서드이름
외부:/oauth/authorizekauth.kakao.comGET인가 코드 요청*
외부:/oauth/tokenkauth.kakao.comPOST토큰 요청
외부:/oauth/tokenkauth.kakao.comPOST토큰 갱신
외부:/oauth/logoutkauth.kakao.comGET카카오계정과 함께 로그아웃
외부:/.well-known/openid-configurationkauth.kakao.comGETOIDC: 메타데이터 조회
외부:/.well-known/jwks.jsonkauth.kakao.comGETOIDC: 공개키 목록 조회
외부:/oauth/tokeninfokauth.kakao.comPOSTOIDC: ID 토큰 정보 조회
* 추가 기능: 로그인 힌트, OpenID Connect ID 토큰 발급, 동의항목 추가 동의 요청, 카카오톡에서 자동 로그인, 서비스 약관 선택해 동의 요청, 채널 선택해 동의 요청, 기존 로그인 여부와 상관없이 로그인
URL호스트메서드이름
내부:/v1/internal/user/signup
외부:/v1/user/signup
kapi.kakao.comPOST수동 연결
내부:/v1/internal/user/unlink
외부:/v1/user/unlink
kapi.kakao.comPOST연결 해제
내부:/v1/internal/user/logout
외부:/v1/user/logout
kapi.kakao.comPOST로그아웃
내부:/v1/internal/user/access_token_info
외부:/v1/user/access_token_info
kapi.kakao.comGET액세스 토큰 정보 조회
내부:/v2/internal/user/scopes
외부:/v2/user/scopes
배치:/v2/internal/user/scopes/batch
kapi.kakao.comGET동의항목 동의 내역 조회
내부:/v2/internal/user/revoke/scopes
외부:/v2/user/revoke/scopes
kapi.kakao.comPOST동의항목 동의 철회
내부:/v2/internal/user/service_terms
외부:/v2/user/service_terms
kapi.kakao.comGET서비스 약관 동의 내역 조회
내부:/v2/internal/user/revoke/service_terms
외부:/v2/user/revoke/service_terms
kapi.kakao.comPOST서비스 약관 동의 철회
내부:/v2/internal/user/upgrade/scopes
외부:/v2/user/upgrade/scopes
kapi.kakao.comPOST고급: 동의항목 동의 처리
내부:/v2/internal/user/upgrade/service_terms
외부:/v2/user/upgrade/service_terms
kapi.kakao.comPOST고급: 서비스 약관에 동의
외부:/v1/oidc/userinfokapi.kakao.comGETOIDC: 사용자 정보 조회
내부:/v1/internal/user/age_auth
외부:/v1/user/age_auth
kapi.kakao.comGET연령인증 정보 조회
URL호스트메서드이름
내부:/v2/internal/user/me
외부:/v2/user/me
kapi.kakao.comGET/POST사용자 정보 조회
외부:/v1/user/idskapi.kakao.comGET사용자 목록 조회
내부:/v2/internal/app/users
외부:/v2/app/users
kapi.kakao.comGET / POST여러 사용자 정보 조회
내부:/v1/internal/user/update_profile
외부:/v1/user/update_profile
kapi.kakao.comPOST사용자 프로퍼티 저장
내부:/v1/internal/user/shipping_address
외부:/v1/user/shipping_address
kapi.kakao.comGET배송지 조회
내부:/v2/internal/user/idkapi.kakao.comGET사용자 ID 조회
내부:/v1/internal/user/group_info
외부:/v1/user/group_info
kapi.kakao.comGET그룹 내 사용자 정보 조회
내부: /v1/internal/user/generate/group_user_token/batchkapi.kakao.comGET그룹 사용자 토큰 생성
내부:/v3/internal/user/appkapi.kakao.comGET연결된 앱 정보 조회
내부:/v2/internal/user/historykapi.kakao.comGET앱 연결 이력 조회
내부:/v1/internal/user/statuskapi.kakao.comGET카카오계정 상태 조회
내부:/v1/internal/user/searchkapi.kakao.comGET카카오계정 검색
내부:/v1/internal/user/touch_accountkapi.kakao.comPOST앱에 연결된 카카오계정 휴면 방지
내부:/v2/internal/user/authenticatekapi.kakao.comPOST앱과 사용자 인증
내부:/v1/internal/user/preregisterkapi.kakao.comGET회원번호 사전 발급
내부:/v2/internal/user/demographics
배치:/v2/internal/user/demographics/batch
kapi.kakao.comGET공동체 앱: 사용자 분석 데이터 조회
내부:/v1/internal/user/precheck/auth_infokapi.kakao.comGET공동체 앱: 본인인증 정보 등록 가능 여부 조회
내부:/v1/internal/user/register/auth_infokapi.kakao.comPOST공동체 앱: 카카오계정에 본인인증 정보 등록
내부:/v1/internal/user/deregister/auth_infokapi.kakao.comDELETE공동체 앱: 카카오계정에서 본인인증 정보 삭제
내부:/v1/internal/user/compare/auth_infokapi.kakao.comGET공동체 앱: 카카오계정과 본인인증 정보 비교
URL호스트메서드이름
내부:/v1/internal/talk/profile
외부:/v1/api/talk/profile
kapi.kakao.comGET카카오톡 프로필 조회
내부:/v2/internal/talk/profiles
외부:/v2/api/talk/profiles
kapi.kakao.comGET / POST사용자 목록으로 카카오톡 프로필 조회
내부:/v1/internal/talk/friends
외부:/v1/api/talk/friends
kapi.kakao.comGET카카오톡 친구 목록 조회
내부:/v2/internal/talk/unread_chatskapi.kakao.comGET읽지 않은 채팅방 목록 조회
내부:/v1/internal/friends
외부:/v1/friends
배치:/v1/internal/friends/batch
kapi.kakao.comGET인하우스 앱: 카카오톡 친구 목록 조회
내부:/v1/internal/talk/chat/list
외부:/v1/api/talk/chat/list
kapi.kakao.comGET인하우스 앱: 채팅방 목록 조회
내부:/v1/internal/talk/chat_info
외부:/v1/api/talk/chat_info
kapi.kakao.comGET인하우스 앱: 채팅방 정보 조회
내부:/v1/internal/talk/members
외부:/v1/api/talk/members
kapi.kakao.comGET인하우스 앱: 채팅방 멤버 조회
내부:/v1/internal/talk/profile/add/musickapi.kakao.comPOST멜론: 카카오톡 프로필 뮤직에 곡 추가
URL호스트메서드이름
외부:/v1/api/talk/friends/message/default/sendkapi.kakao.comPOST기본 템플릿으로 메시지 발송 v1
외부:/v1/api/talk/friends/message/sendkapi.kakao.comPOST사용자 정의 템플릿으로 메시지 발송 v1
외부:/v1/api/talk/friends/message/scrap/sendkapi.kakao.comPOST스크랩 메시지 발송 v1
내부:/v2/internal/talk/memo/default/send
외부:/v2/api/talk/memo/default/send
kapi.kakao.comPOST나에게 기본 템플릿으로 메시지 발송
내부:/v2/internal/talk/memo/send
외부:/v2/api/talk/memo/send
kapi.kakao.comPOST나에게 사용자 정의 템플릿으로 메시지 발송
내부:/v2/internal/talk/memo/scrap/send
외부:/v2/api/talk/memo/scrap/send
kapi.kakao.comPOST나에게 스크랩 메시지 발송
내부:/v2/internal/talk/message/default/send
외부:/v2/api/talk/message/default/send
kapi.kakao.comPOST기본 템플릿으로 메시지 발송
내부:/v2/internal/talk/message/send
외부:/v2/api/talk/message/send
kapi.kakao.comPOST사용자 정의 템플릿으로 메시지 발송
내부:/v2/internal/talk/message/scrap/send
외부:/v2/api/talk/message/scrap/send
kapi.kakao.comPOST스크랩 메시지 발송
내부:/v1/internal/talk/message/invite/blockedkapi.kakao.comGET초대 프로필 공개 상태 조회
내부:/v1/internal/talk/message/feed/blockedkapi.kakao.comGET프로필 공개 상태 조회
내부:/v2/internal/talk/express/message/sendkapi.kakao.comPOST인하우스 앱: 비연결된 사용자에게 메시지 발송
내부:/v2/internal/talk/message/image/upload
외부:/v2/api/talk/message/image/upload
kapi.kakao.comPOST이미지 업로드
내부:/v2/internal/talk/message/image/scrap
외부:/v2/api/talk/message/image/scrap
kapi.kakao.comPOST이미지 스크랩
내부:/v2/internal/talk/message/image/delete
외부:/v2/api/talk/message/image/delete
kapi.kakao.comDELETE이미지 삭제
URL호스트메서드이름
내부:/v1/internal/talk/channels/message/send
배치:/v1/internal/talk/channels/message/send/batch
kapi.kakao.comPOST사용자 정의 템플릿으로 메시지 발송
URL호스트메서드이름
내부:/v1/internal/talk/openchat/create/link
외부:/v1/api/talk/openchat/create/link
kapi.kakao.comPOST채팅방 생성
내부:/v1/internal/talk/openchat/update/link
외부:/v1/api/talk/openchat/update/link
kapi.kakao.comPOST채팅방 정보 변경
내부:/v1/internal/talk/openchat/delete/link
외부:/v1/api/talk/openchat/delete/link
kapi.kakao.comDELETE채팅방 삭제
내부:/v1/internal/talk/openchat/list/link
외부:/v1/api/talk/openchat/list/link
kapi.kakao.comGET / POST오픈채팅 조회
내부:/v1/internal/talk/openchat/join/link
외부:/v1/api/talk/openchat/join/link
kapi.kakao.comPOST채팅방 입장
내부:/v1/internal/talk/openchat/leave/link
외부:/v1/api/talk/openchat/leave/link
kapi.kakao.comPOST채팅방 퇴장
내부:/v1/internal/talk/openchat/update/profile
외부:/v1/api/talk/openchat/update/profile
kapi.kakao.comPOST멤버 프로필 변경
내부:/v1/internal/talk/openchat/reassign/host
외부:/v1/api/talk/openchat/reassign/host
kapi.kakao.comPOST방장 변경
내부:/v1/internal/talk/openchat/assign_remove/admin
외부:/v1/api/talk/openchat/assign_remove/admin
kapi.kakao.comPOST부방장 설정
내부:/v2/internal/talk/openchat/feed/send
외부:/v2/api/talk/openchat/feed/send
kapi.kakao.comPOST피드 등록
내부:/v2/internal/talk/openchat/message/default/send
외부:/v2/api/talk/openchat/message/default/send
kapi.kakao.comPOST기본 템플릿으로 메시지 발송
내부:/v2/internal/talk/openchat/message/send
외부:/v2/api/talk/openchat/message/send
kapi.kakao.comPOST사용자 정의 템플릿으로 메시지 발송
내부:/v2/internal/talk/openchat/message/scrap/send
외부:/v2/api/talk/openchat/message/scrap/send
kapi.kakao.comPOST스크랩 메시지 발송
내부:/v1/internal/talk/openchat/compare/vidkapi.kakao.comGET카카오페이: 오픈채팅 사용자 검증
내부:/v1/internal/talk/openchat/check/memberskapi.kakao.comGET카카오페이: 오픈채팅 멤버 여부 조회
URL호스트메서드이름
내부:/v1/internal/talk/channels/profile
외부:/v1/api/talk/channels/profile
kapi.kakao.comGET카카오톡 채널 프로필 조회
내부:/v2/internal/talk/channels
외부:/v2/api/talk/channels
배치:/v2/internal/talk/channels/batch
kapi.kakao.comGET / POST카카오톡 채널 관계 조회
내부:/v2/internal/talk/channels/multi
외부:/v2/api/talk/channels/multi
kapi.kakao.comGET여러 사용자 카카오톡 채널 관계 조회
내부:/v2/internal/talk/channels/add
외부:/v2/api/talk/channels/add
kapi.kakao.comPOST카카오톡 채널 친구 추가
URL호스트메서드이름
내부:/v2/internal/calendar/calendars
외부:/v2/api/calendar/calendars
kapi.kakao.comGET사용자 캘린더 > 목록 조회
내부:/v2/internal/calendar/create/calendar
외부:/v2/api/calendar/create/calendar
kapi.kakao.comPOST사용자 캘린더 > 서브 캘린더 생성
내부:/v2/internal/calendar/update/calendar
외부:/v2/api/calendar/update/calendar
kapi.kakao.comPOST사용자 캘린더 > 서브 캘린더 수정
내부:/v2/internal/calendar/delete/calendar
외부:/v2/api/calendar/delete/calendar
kapi.kakao.comDELETE사용자 캘린더 > 서브 캘린더 삭제
내부:/v2/internal/calendar/create/event
외부:/v2/api/calendar/create/event
kapi.kakao.comPOST일반 일정 > 생성
내부:/v2/internal/calendar/events
외부:/v2/api/calendar/events
kapi.kakao.comGET일반 일정 > 목록 조회
내부:/v2/internal/calendar/event
외부:/v2/api/calendar/event
kapi.kakao.comGET일반 일정 > 상세 조회
내부:/v2/internal/calendar/update/event/host
외부:/v2/api/calendar/update/event/host
kapi.kakao.comPOST일반 일정 > 수정
내부:/v2/internal/calendar/delete/event
외부:/v2/api/calendar/delete/event
kapi.kakao.comDELETE일반 일정 > 삭제
내부:/v2/internal/calendar/public/create/event
외부:/v2/api/calendar/public/create/event
kapi.kakao.comPOST공개 일정 > 생성
내부:/v2/internal/calendar/public/events
외부:/v2/api/calendar/public/events
kapi.kakao.comGET공개 일정 > 목록 조회
내부:/v2/internal/calendar/public/event
외부:/v2/api/calendar/public/event
kapi.kakao.comGET공개 일정 > 상세 조회
내부:/v2/internal/calendar/public/update/event
외부:/v2/api/calendar/public/update/event
kapi.kakao.comPOST공개 일정 > 수정
내부:/v2/internal/calendar/public/delete/event
외부:/v2/api/calendar/public/delete/event
kapi.kakao.comDELETE공개 일정 > 삭제
내부:/v2/internal/calendar/public/follow
외부:/v2/api/calendar/public/follow
kapi.kakao.comPOST공개 일정 > 사용자 캘린더에 추가
내부:/v2/internal/calendar/subscribable/calendars
외부:/v2/api/calendar/subscribable/calendars
kapi.kakao.comGET구독 캘린더 > 구독 가능 캘린더 목록 조회
내부:/v2/internal/calendar/subscribe
외부:/v2/api/calendar/subscribe
kapi.kakao.comPOST구독 캘린더 > 구독
내부:/v2/internal/calendar/unsubscribe
외부:/v2/api/calendar/unsubscribe
kapi.kakao.comDELETE구독 캘린더 > 구독 해제
내부:/v2/internal/calendar/update/event/guest
외부:/v2/api/calendar/update/event/guest
kapi.kakao.comPOST게스트 일정 > 수정
내부:/v2/internal/calendar/holidays
외부:/v2/api/calendar/holidays
kapi.kakao.comGET공휴일 및 주요 기념일 조회
내부:/v1/internal/calendar/create/task
외부:/v1/api/calendar/create/task
kapi.kakao.comPOST할 일 > 생성
내부:/v1/internal/calendar/tasks
외부:/v1/api/calendar/tasks
kapi.kakao.comGET할 일 > 조회
내부:/v1/internal/calendar/task/records
외부:/v1/api/calendar/task/records
kapi.kakao.comGET할 일 > 도전 기록 조회
내부:/v1/internal/calendar/update/task
외부:/v1/api/calendar/update/task
kapi.kakao.comPOST할 일 > 수정
내부:/v1/internal/calendar/complete/task
외부:/v1/api/calendar/complete/task
kapi.kakao.comPOST할 일 > 완료 여부 설정
내부:/v1/internal/calendar/delete/task
외부:/v1/api/calendar/delete/task
kapi.kakao.comDELETE할 일 > 삭제
내부:/v1/internal/calendar/clear/complete/task
외부:/v1/api/calendar/clear/complete/task
kapi.kakao.comDELETE할 일 > 완료 항목 일괄 삭제
URL호스트메서드이름
외부:/api/v1/message/send/${TYPE}kims-api.kakao.comPOST문자 메시지 발송
외부:/api/v1/messagekims-api.kakao.comGET요청 ID로 발송 결과 조회
외부:/api/v1/message/${MESSAGE_ID}kims-api.kakao.comGET문자 메시지 ID로 발송 결과 조회
외부:/api/v1/message/refusalkims-api.kakao.comPOST수신거부 등록
외부:/api/v1/message/refusalkims-api.kakao.comDELETE수신거부 삭제
외부:/api/v1/mo/requestkims-api.kakao.comPOST문자 메시지 수신 번호 할당
외부:/api/v1/mo/${ID}kims-api.kakao.comGET문자 메시지 수신 상태 조회
URL호스트메서드이름
외부:/v2/ai/newtone-recognize/wsvoice-newtone-biz.kakao.comGET음성 인식 > 단문 인식: 웹 소켓
외부:/v2/ai/newtone-recognize/long/wsvoice-newtone-biz.kakao.comGET음성 인식 > 장문 인식: 웹 소켓
외부:/v2/ai/newtone-recognize/syncvoice-newtone-biz.kakao.comPOST음성 인식 > 동기 인식: 파일 업로드
외부:/v2/ai/newtone-recognize/resultfilevoice-newtone-biz.kakao.comPOST음성 인식 > 비동기 인식: 파일 업로드
외부:/v2/ai/newtone-recognize/getStatusvoice-newtone-biz.kakao.comGET음성 인식 > 음성 파일 업로드 상태 조회
외부:/v1/synthesizevoice-newtone-biz.kakao.comPOST음성 합성
URL호스트메서드이름
내부:/v3/internal/appkapi.kakao.comGET앱 상세 정보 조회
내부:/v1/internal/app/pluginkapi.kakao.comGET플러그인 설정 조회
외부:/v1/ecp_appkapi.kakao.comGETECP 앱 정보 조회
URL호스트메서드이름
내부:/v2/internal/storage/image/upload
외부:/v2/storage/image/upload
kapi.kakao.comPOST이미지 업로드
내부:/v2/internal/storage/image/scrap
외부:/v2/storage/image/scrap
kapi.kakao.comPOST이미지 스크랩
내부:/v2/internal/storage/image/delete
외부:/v2/storage/image/delete
kapi.kakao.comDELETE이미지 삭제
URL호스트메서드이름
내부:/v1/internal/accountkapi.kakao.comGET카카오 API 플랫폼 이용 정보 조회
내부:/v3/internal/account/appskapi.kakao.comGET연결된 앱 목록 조회
내부:/v3/internal/account/appkapi.kakao.comGET연결된 앱 상세 정보 조회
내부:/v3/internal/account/deregistered/appskapi.kakao.comGET연결 해제된 앱 목록 조회
내부:/v3/internal/account/deregistered/appkapi.kakao.comGET연결 해제된 앱 상세 정보 조회
내부:/v1/internal/account/logoutallkapi.kakao.comPOST모든 앱에서 로그아웃
내부:/v1/internal/account/parent_agreementkapi.kakao.comPOST14세 미만 차단 앱에서 로그아웃
내부:/v2/internal/account/app/unlinkablekapi.kakao.comGET연결 해제 가능 여부 조회
내부:/v1/internal/account/unlinkkapi.kakao.comPOST특정 앱과 연결 해제
내부:/v1/internal/account/unlinkallkapi.kakao.comPOST모든 앱과 연결 해제
내부:/v1/internal/account/revoke/service_termskapi.kakao.comPOST약관 동의 철회 시 연결 해제
내부:/v1/internal/account/ageauth/resetkapi.kakao.comPOST연령인증 정보 초기화 상태 반영
내부:/v1/internal/account/deletablekapi.kakao.comGET카카오디벨로퍼스 탈퇴 가능 여부 조회
내부:/v1/internal/account/searchkapi.kakao.comGET이메일로 카카오계정 검색
내부:/v1/internal/user/account/searchkapi.kakao.comGET다른 사용자 카카오계정 조회
URL호스트메서드이름
내부:/v1/internal/user/create_or_updatekapi.kakao.comPOST앱과 사용자 연결
내부:/v2/internal/kakaolink/talk/message/generatekapi.kakao.comPOST메시지 템플릿 객체 생성
내부:/v2/internal/kakaolink/talk/message/checkquotakapi.kakao.comPOST카카오톡 공유 메시지 전달 쿼터 조회
내부:/v1/internal/kakaolink/talk/oscontent/checkquotakapi.kakao.comPOSTOS 공유 쿼터 조회
내부:/v1/internal/talk/channels/broadcast/message/validatekapi.kakao.comPOST발송 대상 목록 유효성 검사
내부:/v1/internal/talk/channels/broadcast/message/sendkapi.kakao.comPOST메시지 대량 발송
내부:/v1/internal/talk/channels/broadcast/message/operationkapi.kakao.comPOST대량 발송 중단
내부:/v1/internal/friends/sdk
외부:/v1/friends/sdk
kapi.kakao.comGETKakao SDK > 피커: 친구 선택
내부:/v1/internal/talk/chat/list/sdkkapi.kakao.comGETKakao SDK > 피커: 채팅방 선택
내부:/v1/internal/talk/members/sdkkapi.kakao.comGETKakao SDK > 피커: 채팅방 멤버 선택
내부:/v2/internal/user/scopes/sdk
외부:/v2/user/scopes/sdk
kapi.kakao.comGETKakao SDK > 피커: 동의항목 동의 여부 조회
내부:/v2/internal/talk/channels/sdkkapi.kakao.comGETKakao SDK > 카카오톡 채널 추가 가능 여부 조회
내부:/v2/internal/talk/channels/add/sdkkapi.kakao.comPOSTKakao SDK > 카카오톡 채널 추가
외부:/v1/app/validate/sdkkapi.kakao.comPOSTKakao SDK > KA 헤더 검증
외부:/v1/user/check_access_tokenkapi.kakao.comGETKakao SDK > 액세스 토큰 만료 시간 조회
내부:/v1/internal/system/health_checkkapi.kakao.comGET카카오 오픈 API 상태 > KAPI 상태 조회
내부:/v1/internal/system/health_check/dapikapi.kakao.comGET카카오 오픈 API 상태 > DAPI 상태 조회
내부:/api/health/currentcapri-status.onkakao.netGET카카오 오픈 API 상태 > 현재 상태 조회
내부:/api/health/historycapri-status.onkakao.netGET카카오 오픈 API 상태 > 이력 조회
내부:/api/maintenancecapri-status.onkakao.netGET카카오 오픈 API 상태 > 점검 일정 조회
URL호스트메서드이름
내부:/v1/internal/payment/statisticskapi.kakao.comGET카카오페이: 사용자 통계 조회
외부:/v2/user/gift_purchase_historykapi.kakao.comGET카카오뱅크: 카카오 선물하기 서비스 이용 내역 조회
외부:/v2/user/taxi_purchase_historykapi.kakao.comGET카카오뱅크: 카카오T 서비스 이용 내역 조회
내부:/v1/internal/account/business/deletablekapi.kakao.comGET카카오비즈니스: 탈퇴 가능 여부 조회
내부:/v1/internal/ecp_appkapi.kakao.comPOST카카오비즈니스: 쇼핑몰 앱 정보 조회
내부:/v1/internal/user/plugin/completekapi.kakao.comPOST싱크 플러그인: 회원 가입 완료 처리
URL호스트메서드이름
내부:/v1/internal/app/checkquotakapi.kakao.comPOST패시브 연동
URL호스트메서드이름
내부:/v1/internal/alfs/ruleskapi.kakao.comGET쿼터 규칙 목록 조회
내부:/v1/internal/alfs/countkapi.kakao.comGET쿼터 카운트 정보 조회
내부:/v1/internal/alfs/increasekapi.kakao.comPOST쿼터 카운트 증가
내부:/v1/internal/alfs/decreasekapi.kakao.comPOST쿼터 카운트 감소
내부:/v1/internal/alfs/checkkapi.kakao.comPOST쿼터 카운트 검사
내부:/v1/internal/alfs/resetkapi.kakao.comPOST쿼터 카운트 초기화
  • 지원 범위: 카카오 API의 사용자 연결 상태에 따른 호출 제한 및 Kakao SDK 지원 여부 안내

도움이 되었나요?