사이드 메뉴
커뮤니케이션
API 제공
어드민 API
앱 설정
유료 API
이 문서는 카카오 또는 공동체 서비스가 유료 API 사용 시 필요한 설정에 대해 안내합니다. 공통 설명은 오픈 문서를 참고합니다.
앱 타입별 쿼터
- 카카오 서비스: 인하우스 앱으로 변경하면 쿼터 제한 없이 카카오 API를 무료로 사용할 수 있습니다.
- 공동체 서비스: 공동체 앱으로 변경 후, 유료 API 설정을 완료하면 인하우스용 유료 API를 호출할 수 있습니다.
- 참고: 앱 타입 변경 요청하기
페이즈 지원 범위
카카오디벨로퍼스 유료 API 설정은 알파(Alpha) 페이즈를 지원하지 않습니다.
카카오 또는 공동체 서비스가 유료 설정을 적용할 수 있는 API 목록입니다. 앱이 권한을 가지고 있는 항목만 목록에 표시됩니다. API별 실제 사용량을 집계하고 요금을 청구하는 세부 API 목록은 추가 쿼터 사용 요금에서 확인할 수 있습니다.
| API | 설명 | 관련 문서 |
|---|---|---|
| 카카오톡 친구 목록 | 카카오톡 친구 목록과 피커 기능 제공 | 카카오 소셜 |
| 카카오톡 채팅방 목록 | 카카오톡 채팅방 목록과 피커 기능 제공 | 카카오 소셜 |
| 카카오톡 채팅방 멤버 목록 | 카카오톡 채팅방 멤버 목록과 피커 기능 제공 | 카카오 소셜 |
| 카카오톡 메시지 | 카카오톡 사용자간 메시지 전송 기능 제공(카카오톡 공유 제외) 중요 카카오톡 친구 목록 또는 카카오톡 채팅방 목록 API의 사용 권한이 있는 경우, 카카오톡 메시지 API에 대한 유료 설정 가능 | 카카오톡 메시지 |
| 카카오톡 오픈채팅 | 서비스 앱 사용자만 참여 가능한 카카오톡 오픈채팅 기능 제공 | 카카오톡 오픈채팅 |
| 카카오맵 | 웹과 앱 서비스에서 사용할 수 있는 카카오맵의 콘텐츠와 데이터 제공 | 지도 로컬 |
| 문자 메시지 | 국내 및 해외 사용자에게 문자 메시지 전송 및 수신 기능 제공 중요 문자 메시지는 무료 쿼터 없이 유료로만 제공 앱 관리 페이지의 [문자 메시지]에서 관련 설정 가능 | 문자 메시지 |
앱 관리 페이지의 [유료 API] > [사용 가능한 유료 API]에서 각 유료 API의 [설정]을 선택해 사용 가능한 유료 API의 유료 사용 여부를 설정할 수 있습니다. 유료로 사용하도록 설정하려면 앱과 비즈월렛이 서로 연결되어 있어야 합니다.
| 설정 | 설명 |
|---|---|
| 사용 안 함 | 유료로 사용하지 않도록 설정 |
| 사용 중 | 유료 사용하도록 설정, 유료 사용량에 따라 비즈월렛으로 비용 청구 |
| 사용 중 청구 제외 | 유료로 사용하도록 설정 및 비즈월렛으로 비용이 청구되지 않음, 별도의 API 사용 및 정산 계약 시에만 설정 가능 |
변경 시 주의사항
유료 API의 설정을 [사용 중]에서 [사용 안 함]으로 변경할 경우, 쿼터 초과 에러로 서비스 장애가 발생할 수 있습니다. 설정 변경 시 서비스 상태와 쿼터 잔여량을 반드시 확인해야 합니다.
앱 관리 페이지의 [유료 API] > [일반] > [유료 API 사용 한도]에서 유료 API의 사용 한도를 설정하거나 상태를 확인할 수 있습니다.
한도 금액 제한이 있는 유료 API 중, 사용 설정 중인 제품만 노출됩니다.
| 항목 | 설명 |
|---|---|
| 기간별 한도 | 일 한도 또는 월 한도 |
| 상세 구분 | 국내 또는 해외 |
| 최대 사용 한도 | [문자 메시지] > [일반]에서 사용 설정 시, 기본 값인 일 한도 100만원, 월 한도 2,000만원이 자동 적용 한도가 설정되지 않은 경우(무제한), - 표시 |
| 사용 금액 | 일간 또는 월간 유료 API 사용 금액 한도가 설정되지 않은 경우(무제한), - 표시 한도가 설정된 API의 사용 금액은 5분 단위로 집계되어, 1시간 단위로 집계되는 [유료 API 사용 내역] 페이지와 사용 금액이 다를 수 있음 참고: 해외 국가에서 비정상적인 이용을 방지하려면 [문자 메시지] > [국가 메시지 설정]에서 특정 국가로 메시지 발송을 차단하거나 알림 설정 (참고: 국제 메시지 설정) |
| 사용률 | 최대 사용 금액 대비 사용 금액 비율 |
| 상태 | 유료 API 호출 가능 상태
중요: 일 또는 월 한도 둘 중 하나라도 한도 초과 시, API 호출 불가 API 호출 제한을 해제하려면 더 높은 금액으로 한도 변경 |
| 관리 | 한도 금액을 변경하려면 [설정]을 눌러 [한도 금액]의 입력값 변경 한도 제한 없이 API를 호출하도록 허용하려면, 입력란을 비워두고(공란) 저장 |