This document guides how to use the REST API provided by the Kakao API platform.
Most Kakao APIs are provided as a REST API, except for Kakao Talk Share or some plugin features related to service UI. Kakao APIs not supported by Kakao SDK are also available through a REST API.
REST API is available in any environment where HTTP request is possible. It is used to send requests from a client to a server or from a server to another server. Examples are below.
Refer to Reference to check the request and response specifications.
To use Kakao APIs through a REST API, the server and development environments must meet the following minimum versions.
Name | Supported version |
---|---|
OS X | Mavericks or higher |
Windows | Windows XP SP3 or higher |
Java | JRE 1.8.0_101 or higher |
Browser | Chrome 49 or higher Firefox 50 or higher Safari 10 or higher Internet Explorer (IE) 9 or higher Microsoft Edge 14 or higher |
CentOS/RHEL | ca-certificates-2015.2.4-65.0.1.el6_6.noarch or higher |
* Notice: Replacing SSL certificates in Kakao Open API Platform
Go to [My Application] > [Platform] and enter the web platform information of the service. Refer to Platform.
For services in operation, this setting may affect the functions that use the Kakao API. Be aware contents below before using this.
To prevent security incidents such as app key leakage, set the IP address to be allowed.
Go to [My Application] > [Allowed IP address] > [Register allowed IP address] and enter the service server's IP addresses to be allowed. Registering CIDR(IP/CIDR) or Subnet Mask(IP/Mask) information is recommended, but individual IP(IPv4, IPv6) is also supported. To register multiple IP addresses, separate them with line breaks.
Allowed IP address setting is applied to all Kakao API calls with the REST API key or the Admin key. After any IP address is registered, only REST API calls from the registered IP address will be allowed. If a request has been sent from an unregistered IP address, the following error is returned. To solve this issue, register the IP address of the server to send a request from, or disable this feature.
"msg": "ip mismatched! callerIp=XXX.XXX.XXX.XXX. check out registered ips.",
"code": -401
To disable this feature, delete all registered IP addresses by clicking [Delete].
If access to the service server is restricted by the firewall or ACL (Access Control List), set the firewall rules or ACL to use Kakao API. To check the Kakao IP list, call Retrieve Kakao IP list.
REST API requests can be implemented with various programming languages. The examples are below.
For reference or samples of other languages and frameworks not provided in this documentation, search it or ask us in Devtalk.