페이지 이동경로
  • 문서>
  • REST API>
  • 시작하기

REST API

시작하기

이 문서는 카카오 API 플랫폼에서 제공하는 REST API 사용 방법을 안내합니다.

준비

기능 소개

카카오 API는 대부분의 기능을 REST API로 제공합니다. 카카오톡 공유나 서비스 UI와 관련 있는 플러그인 성격의 일부 기능을 제외하고 모든 기능을 서비스 서버에서 REST API로 구현할 수 있습니다. 또한 카카오 SDK가 지원하지 않는 카카오 API는 REST API로 사용 가능합니다.

REST API는 HTTP 요청을 보낼 수 있는 환경이라면 어디서든 이용 가능합니다. 클라이언트에서 서버로, 또는 서버에서 서버로 요청을 보낼 수 있습니다. 예를 들면 아래와 같은 환경에서 REST API를 사용할 수 있습니다.

  • 모바일/PC 웹 환경
  • iOS, Android 등 모바일 환경
  • Java, Ruby, Python 등 다양한 환경의 웹 서버

요청, 응답 규격은 레퍼런스에서 확인할 수 있습니다.

요구 사양

카카오 API 플랫폼에서 제공하는 REST API는 SSL(Secure Sockets Layer)이 적용된 HTTPS 프로토콜로만 호출 가능합니다. 이 외 개발 환경 요구 사양은 아래의 지원 버전 정보를 참고합니다.

이름 버전
OS X Mavericks 이상
Windows Windows XP SP3 이상
Java JRE 1.8.0_101 이상
브라우저 Chrome 49 이상
Firefox 50 이상
Safari 10 이상
IE(Internet Explorer) 9 이상
Edge 14 이상
CentOS/RHEL ca-certificates-2015.2.4-65.0.1.el6_6.noarch 등

* 참고: 카카오 Open API 플랫폼 SSL 인증서 변경

* IE를 제외한 다른 브라우저의 최신 버전 사용 권장

플랫폼

앱 관리 페이지의 [앱] > [일반] > [플랫폼]에서 사이트 도메인을 비롯한 Web 플랫폼 정보를 입력해야 합니다. 자세한 안내는 플랫폼을 참고합니다.

보안: 허용 IP 주소

허용 IP 주소를 설정하면 카카오 API 서버가 등록된 IP 주소의 요청만 허용하도록 해 앱 키 유출과 같은 보안 사고에 대비할 수 있습니다. 설정 방법은 허용 IP 주소를 확인합니다.

ACL 설정

서비스의 방화벽에서 ACL(Access Control List, 접근 제어 목록)로 서비스 서버 접근을 제한하는 경우, 카카오 API를 사용하려면 ACL을 설정해야 합니다. 방화벽을 참고합니다.

테스트 도구

카카오디벨로퍼스는 REST API를 개발하고 디버깅할 때 유용한 REST API 테스트 도구를 제공합니다.

예제

다양한 프로그래밍 언어로 REST API 요청과 응답 처리를 구현할 수 있습니다. 아래는 REST API를 사용하는 언어별 참고 예제입니다.

이 문서에서 제공하지 않는 다른 언어 및 프레임워크(Framework)의 참고 자료나 예제는 데브톡에서 검색 또는 문의합니다.

참고: 튜토리얼