페이지 이동경로
  • 문서>
  • 유용한 참고 정보>
  • 용어집

유용한 참고 정보

용어집

이 문서는 카카오디벨로퍼스의 문서에 등장하는 용어에 대해 자세히 설명합니다.

• ㄴ • • ㄹ • ㅁ • • ㅈ •

A • B • C • D • E • F • G • H • I • J • K • L • M • N • O • P • Q • RS • T • U • V • W • X • Y • Z

용어 설명
기본 메시지 템플릿 서비스에서 간편하게 메시지를 보낼 수 있도록 자주 사용하는 메시지 형식을 템플릿으로 제공합니다. 피드, 리스트, 위치, 커머스, 텍스트 총 5가지의 템플릿이 있습니다. 줄여서 '기본 템플릿'이라고 칭합니다.
간편가입
동의 화면
(Simple Signup
Consent screen)
카카오싱크를 이용하는 애플리케이션에서 사용자가 처음 로그인할 때 출력되는 동의 화면입니다. 일반적인 카카오 로그인 동의 화면과 달리, 서비스 이용약관과 카카오톡 채널 추가 항목을 포함합니다.
고객파일
(Customer file)
카카오톡 채널에서 메시지를 발송하기 위한 수신자 그룹을 설정할 때, 사용자 정보를 포함한 고객파일을 참고할 수 있습니다. 고객파일은 카카오톡 채널 관리자센터에서 관리자가 업로드하거나, API를 통해 등록 및 관리할 수 있습니다.
권한
(Permission)
특정 기능이나 API를 사용하기 위하여, 혹은 서비스에서 필요한 사용자 정보에 접근하기 위한 자격을 의미합니다. API를 사용하기 전에 각 API 별로 필요한 권한이 무엇인지 [설정하기] 가이드에서 확인한 후, 필요한 권한을 요청합니다.
권한 부여
(Authorization)
인가 참고

용어 설명
동의 항목
(Consent item)
사용자가 카카오 로그인 시 동의 화면에서 제3자 제공동의 여부를 선택해야 하는 사용자 정보 항목을 지칭합니다.

용어 설명
비즈 앱
(Biz app)
서비스를 소유한 사업자 정보를 등록한 앱을 지칭합니다. 특정 API(친구 목록 가져오기, 카카오톡 메시지 보내기)나 서비스(카카오싱크)를 사용하려면 반드시 비즈 앱으로 전환해야 합니다. 비즈 앱 전환 시, 기본 앱에서 제공되지 않는 동의 항목을 검수 과정 없이 활성화하거나, 추가적인 기능을 사용할 수 있습니다. 자세한 정보는 비즈 앱을 참고합니다.
비즈니스 채널
(Business Channel)
서비스를 소유한 사업자 정보를 등록한 카카오톡 채널을 지칭합니다. 카카오톡 채널 관리자센터에서 카카오톡 채널을 새로 등록하고, 비즈니스 채널로 전환할 수 있습니다. 비즈니스 채널이 등록되어야 카카오싱크 이용 시, 카카오싱크 간편 가입 동의화면에서 카카오톡 채널을 추가할 수 있는 동의 항목이 나타납니다.

용어 설명
사용자
(User)
파트너가 구현한 서비스를 이용하는 최종 사용자(End user)를 지칭합니다.
사용자 인자
(User argument)
사용자 정의 메시지 등록 시 변동되는 정보가 들어갈 위치에 사용자 인자를 설정하고, 실제 메시지 발송 요청 시 각 사용자 인자 값을 전달하는 방식으로 각 사용자 또는 상황에 맞춰 메시지를 구성할 수 있습니다.
사용자 정의 메시지 템플릿 기본으로 제공되는 메시지 템플릿을 서비스에 맞게 구성할 수 있는 템플릿으로 [도구] > [메시지 템플릿]에서 손쉽게 사용자 정의 템플릿을 등록하고 수정할 수 있습니다. 줄여서 '사용자 정의 템플릿'이라고 칭합니다.
서비스
(Service)
파트너가 소유 및 운영하는 제품을 말합니다. 주로 웹 사이트나 애플리케이션의 형태이며, 이 밖의 형태일 수 있습니다.
소재
(Creative)
웹사이트나 앱과 같은 디지털 환경에 게재되는 광고를 지칭합니다. 배너형 광고에 사용하는 이미지나 동영상 파일, 혹은 메시지를 전송할 때 사용하는 메시지 본문 내용을 소재라 할 수 있습니다.
스키마
(Schema)
스키마란 흔히 데이터베이스 관리 시스템에서 어떻게 데이터를 구성할지에 대한 청사진으로써 데이터를 저장하는 구조와 표현법을 정의한 것입니다.
카카오톡 채널 고객 관리 API에 사용하는 '스키마'란 고객 파일에 등록할 수 있는 데이터 항목과 항목의 자료형, 입력 양식을 정의한 규칙을 의미합니다. 고객 파일에는 지정된 스키마에 따른 데이터만 등록할 수 있으므로, 카카오톡 채널 관리자센터 공지사항를 참고하여 올바른 형태의 고객 정보를 등록해야 합니다.

용어 설명
애플리케이션
(Application)
'앱' 참고
액세스 토큰
(Access token)
OAuth 2.0 기반 인증 체계에서 사용하는 토큰 중 하나로, 사용자를 대신하여 앱에게 요청한 데이터에 접근하거나 API 요청의 권한을 위임하는 역할을 합니다. 액세스 토큰은 일정 시간 사용자의 자격 증명을 수행하기에 사용자가 매번 인증을 거치지 않고도 일정 기간 카카오 API를 사용할 수 있도록 합니다. 토큰의 유효기간을 확인하려면 토큰 정보를 참고합니다.

(App)
'애플리케이션'을 줄여서 '앱'이라고 표기합니다. 흔히 사용하는 '모바일 앱'을 의미하는 단어가 아닌, 개발자 웹사이트에 등록된 서비스 정보를 의미합니다. 카카오 API 이용을 위해 서비스 정보 일부를 카카오 플랫폼에 등록하여 권한을 부여받기 위한 도구입니다.
앱 유저 ID
(App user ID)
회원번호를 의미합니다.
앱 키
(App key)
카카오 API 사용에 필요한 권한을 식별하는 키입니다. 개발자 웹사이트에서 [내 애플리케이션] 메뉴에서 앱을 생성하면 네 종류의 앱 키(App key)가 발급됩니다. iOS와 Android를 통해 앱을 개발할 경우, 네이티브 앱 키를 사용하며, JavaScript를 통해 웹을 개발할 경우 JavaScript 키를 사용합니다. HTTP 요청이나 서버 기능 구현에는 REST API 키를 사용합니다. Admin 키는 사용자 인증이나 앱 인증 시 필요합니다. 카카오 API 호출 시 플랫폼에 맞지 않는 앱 키를 사용하면 에러가 발생하므로, 개발 환경이나 상황에 맞는 앱 키를 사용해야 합니다.
앱 ID 각 애플리케이션에 부여된 ID입니다. 앱 키와 별개의 값이며, 모든 앱은 각기 다른 ID를 부여받습니다. 앱 ID는 데브톡 문의 시 앱 정보를 명시하기 위해 사용할 수 있습니다. [내 애플리케이션]의 앱 목록이나 [내 애플리케이션] > [앱 설정] > [요약 정보]에서 각 앱 ID를 확인할 수 있습니다.
어드민 키
(Admin key)
앱 키의 종류 중 하나로, 애플리케이션 관리자를 위해 최고 등급의 권한을 인증하는 값입니다. 애플리케이션에 치명적인 영향을 줄 수 있는 기능은 어드민 키를 사용해 호출하도록 되어 있습니다. 따라서 어드민 키 유출 시, 보안 문제가 발생할 수 있으므로 유출되지 않도록 주의하여야 합니다. 대표적으로 애플리케이션 전체 사용자 목록을 불러오는 사용자 목록 가져오기 API가 해당합니다.
에디터
(Editor)
개발자 웹사이트에서 팀원으로 등록되어 앱 개발에 참여할 수 있는 권한 중 하나입니다. 앱 개발에 에디터로 등록된 계정은 앱의 정보를 조회하거나 수정할 수 있습니다.
연결
(Link)
카카오 로그인을 통해 사용자가 서비스 앱의 사용자로 등록되는 과정을 앱과 '연결'되었다고 표현합니다. 즉, 사용자와 앱의 관계에 해당합니다. 카카오계정 로그인 시 서비스와 연결할 뿐, 서비스 데이터에는 접근하지 않기 때문에 사용자 정보를 회원 데이터베이스에 저장하는 등 실질적인 가입 처리는 서비스에서 자체적으로 구현해야 합니다.
연계정보
(Connecting
Information)
CI 참고
오너
(OWNER)
개발자 웹사이트에 등록된 앱의 소유자를 지칭합니다. 앱을 등록한 사용자인 경우가 일반적이지만, 설정에 따라 팀원 중 한 사람이 오너가 될 수도 있습니다. 오너의 경우 앱의 모든 권한을 보유합니다.
오픈 API
(Open API)
카카오 플랫폼에 앱을 등록한 개발자는 누구나 사용할 수 있도록 제공되는 API입니다. 플랫폼 정책 범위 안에서 무료로 이용할 수 있습니다.
유니버셜 링크
(Universial Links)
하나의 URL로 웹페이지와 앱 화면으로 모두 연결할 수 있는 표준 웹 링크로, 앱의 설치 여부와 상관 없이 사용자가 지정한 링크의 컨텐츠를 확인할 수 있습니다. 사용자가 유니버셜 링크를 선택하면 iOS는 먼저 사용자의 기기에 해당 앱이 설치되었는지 확인합니다. 앱이 설치되어 있으면 앱을 실행하여 해당 컨텐츠를 포함한 앱 화면으로 리다이렉트하고, 앱이 설치되지 않은 경우에는 Safari를 통해 해당 링크를 엽니다. 이 기능은 iOS 9 버전 이상에서 제공합니다.
인가
(Autorization)
자격이 증명된 사용자나 앱에게 요청한 기능이나 접근 권한을 허용해 주는 행위를 의미합니다.
인가 코드
(Autorization
code)
OAuth 2.0 기반 인증 체계에서 사용자의 자격 정보를 확인하는 값으로, 숫자와 알파벳으로 구성된 임시 코드입니다. 카카오 로그인 시 카카오계정의 사용자 자격정보를 인가 코드로 받아온 후, 토큰과 교환을 위해 사용됩니다. 인가 코드를 발급받아야 액세스 토큰과 리프레시 토큰을 얻을 수 있습니다.
인증
(Authentication)
사용자의 신원을 확인하여 자격을 증명하는 과정을 의미합니다.

용어 설명
친구 카카오톡에 등록된 사용자를 친구로 지칭하며, 카카오톡 채널의 경우 해당 카카오톡 채널을 추가한 사용자를 친구라고 지칭합니다.
친구그룹 고객파일에서 사용자의 성별, 나이, 지역, 등급 등의 추가 정보를 토대로 친구그룹을 만들거나 전화번호를 직접 입력해서 친구그룹을 만들 수 있습니다. 메시지를 보낼 대상을 그룹화하여, 보다 높은 효과가 기대되는 사용자들에게 타게팅 메시지를 보낼 수 있습니다.

용어 설명
카카오톡 채널
관리자센터
(Kakao Talk Channel
Admin Center)
카카오톡 채널을 새로 생성하거나 생성한 카카오톡 채널을 비즈니스 채널로 전환할 수 있는 관리자센터입니다. 미리 지정한 친구 그룹에게 타깃 메시지를 발송할 수도 있습니다.
카카오디벨로퍼스
(Kakao
Developers)
카카오 개발자 웹사이트의 공식 명칭으로, 사용자가 카카오 플랫폼에서 제공하는 서비스를 이용하는데 필요한 다양한 툴과 제품 소개 및 개발 문서를 제공합니다. 이곳에서 개발에 필요한 앱을 등록하거나 테스트 툴, 데모 페이지 등을 이용할 수 있으며, 개발에 필요한 리소스와 SDK를 다운로드할 수 있습니다. 더불어 [포럼]에서 사용자 피드백을 전달하거나 질문을 남길 수 있습니다.
카카오비즈니스
(Kakao
Business)
카카오 계정 하나로 비즈니스와 관련된 서비스를 신청하고 필요한 정보들을 관리할 수 있는 비즈니스 플랫폼입니다. 이곳에서 카카오싱크를 비롯하여 모먼트, 키워드 광고와 카카오톡 채널을 이용할 수 있습니다.
커스텀 URL 스킴
(Custom URL Scheme)
특정 앱이나 웹 페이지를 열게하는 특별한 형식의 URI 스킴(Scheme)입니다. 카카오에서 제공하는 서비스를 사용하기 위해 설정해야 하는 URI 스킴 형식은 kakao${YOUR_NATIVE_APP_KEY} 입니다. 카카오 로그인을 구현하려면 인가코드를 전달 받을 Redirect URI에 접근하기 위하여 kakao${YOUR_NATIVE_APP_KEY}://oauth의 형식의 커스텀 URL 스킴을 사용합니다. 카카오스토리 앱을 실행시키는 커스텀 URL 스킴을 설정하려면 kakao${YOUR_NATIVE_APP_KEY}://kakaostory를, 카카오톡 메시지에서 특정 웹 페이지나 앱을 실행하려면 kakao${YOUR_NATIVE_APP_KEY}://kakaolink 형식의 커스텀 URL 스킴을 사용합니다. URI 스킴 설정 방법은 AndroidiOS를 참고합니다.
커스텀 파라미터
(Custom parameter)
서비스의 필요에 따라 전달해야할 정보를 키와 값의 형태로 커스텀 URL 스킴에 추가한 파라미터입니다. 앱의 특정 게시물로 이동하게 하거나 초기값을 지정하는데 활용할 수 있습니다. 예를 들어, androidExecutionParams = mapOf("key1" to "value1") 형태로 전달하고자 하는 키와 값을 추가하면, kakao${YOUR_NATIVE_APP_KEY}://kakaolink?$key1=value1와 같은 형식으로 커스텀 URL 스킴이 호출됩니다.
쿼리 스트링 파라미터
(Query string parameter)
API 호출 시, 서버에 추가적인 정보를 전달할 때 사용합니다. 요청 URL 뒤에 물음표(?)를 시작으로 parameter=value 형태로 전달하며, 복수의 파라미터 전달 시 앰퍼샌드(&)로 구분합니다.
예를 들어, https://kauth.kakao.com/oauth/authorize?response_type=code&client_id=${REST_API_KEY}에서 response_type=code&client_id=${REST_API_KEY}가 쿼리 스트링 파라미터이며, response_type이 파라미터 이름, code가 해당 파라미터의 값을 의미합니다.

용어 설명
토큰 액세스 토큰과 리프레시 토큰 두 가지 타입으로 사용자가 로그인 시 발급됩니다. 사용자의 권한을 증명하는 수단으로 토큰을 발급받으면 해당 토큰의 유효기간 동안 매번 인증을 거치지 않고도 카카오 API를 사용할 수 있습니다.

용어 설명
퍼머링크
(Permalink)
카카오가 제공하는 짧게 축약된 형태의 연결용 URL로, 오프라인 QR 코드, 광고 랜딩 페이지 등을 위해 사용할 수 있습니다. 카카오싱크 퍼머링크에 대한 자세한 내용과 발급 방법은 데브톡 공지사항에서 확인할 수 있으며, 필요 시 카카오싱크 고객센터를 통해 요청할 수 있습니다. QR 코드 스캔 시 이동하는 페이지 주소를 카카오톡 퍼머링크로 설정한다면 사용자가 보다 편리하게 가입할 수 있습니다.
파트너 카카오 플랫폼을 이용하는 제휴사를 지칭합니다. 대부분의 카카오 API는 무료로 제공되는 오픈 API이지만, 카카오싱크, 카카오페이와 같이 서비스의 특정 기능을 이용하려는 경우나 쿼터 제한 상향을 위해서는 제휴를 맺어야 합니다. 제휴 안내는 서비스의 각 [이해하기] 가이드를 참고합니다.

용어 설명
하이브리드 앱 하이브리드 앱은 모바일 웹과 Android, iOS 등 모바일 플랫폼 네이티브 앱이 결합된 형태의 앱으로, 네이티브 앱을 통해 모바일 웹 기반으로 개발된 콘텐츠를 불러와 사용하는 방식으로 동작합니다. 하이브리드 앱은 웹과 앱의 장점을 모두 가지고 있고, 모바일 웹의 공통 플랫폼별 앱 개발 기간이 상대적으로 빠른 앱 개발을 위해 사용되는 방식입니다.
회원번호
(Service user ID)
서비스에서 각 사용자를 식별할 수 있는 고유한 값으로, 사용자가 카카오 로그인 시 [동의하고 계속하기]를 누를 때 발급됩니다. 회원번호는 서비스의 회원 ID 역할을 하므로 앱 단위로 발급됩니다. 따라서 같은 사용자라도 다른 앱에서는 다른 회원번호를 발급받습니다.
헤더 파라미터
(Header parameter)
요청 헤더에 포함되는 파라미터로 보통 인증과 관련한 파라미터입니다.

A

용어 설명
API Application Programming Interface의 약자로, 카카오에서 제공하는 서비스를 클라이언트(Client)나 서버에서 HTTP 프로토콜로 호출하여 사용할 수 있도록 제공하는 인터페이스입니다.

C

용어 설명
curl 다양한 프로토콜을 이용하여 서버와 통신하고 데이터를 전송하기 위한 명령어 툴(command line)로, 무료로 제공되는 오픈 소스 소프트웨어입니다. REST API를 지원하는 API의 경우, curl을 설치한 후에 curl 명령어로 API를 요청할 수 있습니다.
CI
(Connecting
Information)
사용자 인증을 위해 사용되는 암호화된 값입니다.

J

용어 설명
JSON JavaScript Object Notation의 약자로, API 요청과 응답에서 데이터를 저장하고 전달하기 위하여 읽기 쉬운 형태로 나타낸 데이터 형식입니다. "key": "value" 형식으로 구성된 객체나 배열의 형태로 데이터를 구분합니다. JavaScript SDK와 REST API를 이용하여 호출한 대부분의 카카오 API의 응답은 JSON 형식으로 반환됩니다.

O

용어 설명
OAuth 사용자의 아이디와 비번을 사용하지 않고 토큰을 이용해 사용자의 자격을 증명하고, 웹사이트나 애플리케이션에 접근하도록 허용하는 표준 인증 방식을 의미합니다.

R

용어 설명
REST API Representational State Transfer Application Programming Interface의 약자로, HTTP 프로토콜을 사용하여 애플리케이션 간에 데이터를 전송하거나 처리하는 인터페이스를 의미합니다. 사용자 정보나 카카오톡 메시지 등과 같은 리소스(Resource)를 어떻게(Method) 처리할지 — 예를 들어 생성할지(POST), 조회할지(GET), 수정할지(PUT), 삭제할지(DELETE) — HTTP 기반으로 정의해놓은 아키텍처입니다. REST 기반으로 서비스 API를 구현하는 것을 REST API라고 합니다.

S

용어 설명
SDK Software Development Kit의 약자로, 카카오에서 제공하는 다양한 서비스를 쉽게 개발할 수 있도록 필요한 툴들을 하나로 모아 제공하는 패키지입니다. 카카오 SDK는 카카오 플랫폼 서비스를 이용하여 앱이나 웹을 개발할 수 있도록 샘플 앱을 제공합니다. 플랫폼 별 SDK는 [SDK 다운로드] 메뉴에서 다운로드할 수 있습니다.

U

용어 설명
UUID Universally Unique Identifier의 약자로, 각 앱에서 친구마다 발급되는 고유한 식별자 코드입니다. 카카오톡 메시지를 보내기 위해 필요하므로, 메시지를 보내기 전 친구 목록 가져오기 API를 통해 UUID를 가져옵니다.
유용한 참고 정보> 용어집