This document provides the Utility API information for Kakao API platform users.
Method | URL | Authorization |
---|---|---|
GET |
https://kapi.kakao.com/v1/system/ips |
Native app key REST API key JavaScript key Admin key |
Permission | Prerequisite | Kakao Login | User consent |
---|---|---|---|
- | - | - | - |
Retrieve Kakao IP list to use Kakao APIs. If access to the service server is restricted by the firewall or ACL (Access Control List), you must set the Kakao service server's IP on the firewall rules or ACL.
유형 | 설명 |
---|---|
Inbound | Required IPs to get the request from Kakao. One of the request types below. callback : Callbackscrap : A request to scrape a service page |
Outbound | Required IPs to use Kakao APIs. One of the Kakao service domains below. https://kauth.kakao.com : Kakao Login APIhttps://kapi.kakao.com : Kakao APIhttps://accounts.kakao.com : Kakao Accounthttps://auth.kakao.com : Kakao Account(Mobile)https://dapi.kakao.com : Daum search, local APIhttps://apps.kakao.com : Kakao Talk Message APIhttps://talk-apps.kakao.com : Kakao Talk universal link |
Send a GET
request with one of service app keys in the header. To retrieve only one of either inbound or outbound, use rule_type
.
The response includes the inbound and outbound Kakao IP list. If failed, refer to Error code to figure out the reason.
Name | Description | Required |
---|---|---|
Authorization | Authorization: KakaoAK ${SERVICE_APP_KEY} Service app key as a type of user authentication. One of: Native app key REST API key JavaScript key Admin key |
O |
Name | Type | Description | Required |
---|---|---|---|
rule_type | String |
IP type to retrieve. One of inbound and outbound . |
X |
Name | Type | Description | Required |
---|---|---|---|
inbound | IP[] |
Inbound IP list of each Kakao service. | X |
outbound | IP[] |
Outbound IP list of each Kakao service. | X |
updatedDate | String |
The last updated date in YYYY-MM-DD (ISO 8601) Format. |
O |
Name | Type | Description | Required |
---|---|---|---|
service | String |
The service names or the service domain. Refer to Kakao service information. |
O |
ips | String[] |
The IP list of each Kakao service. RFC1519 CIDR format. |
O |
ports | Int[] |
The port list of each Kakao service. | O |
addition | IpChange |
The IP information to be added. | X |
exclusion | IpChange |
The IP information to be excluded. | X |
updatedDate | String |
The last updated date in YYYY-MM-DD (ISO 8601) Format. |
O |
Name | Type | Description | Required |
---|---|---|---|
ips | String[] |
The IP list to be added or excluded. RFC1519 CIDR format. |
O |
date | String |
The addition or exclusion schedule. | O |
curl -v -X GET "https://kapi.kakao.com/v1/system/ips" \
-H "Authorization: KakaoAK ${REST_API_KEY}"
curl -v -G GET "https://kapi.kakao.com/v1/system/ips" \
-H "Authorization: KakaoAK ${REST_API_KEY}" \
-d "rule_type=inbound"
HTTP/1.1 200 OK
{
"inbound": [
{
"service": "callback",
"ips": [
"211.249.203.104/24",
"220.64.110.190/25",
"220.64.111.158/25",
"220.64.109.84/31",
"203.217.230.3/26"
],
"ports": [
443
],
"updatedDate": "2023-06-28"
},
...
],
"outbound": [
{
"service": "https://kauth.kakao.com", // If there is no list of IPs to be added
"ips": [
"203.133.166.32/32",
"27.0.237.15/32"
],
"ports": [
443
],
"updatedDate": "2023-06-28"
},
{
"service": "https://kapi.kakao.com", // If there is a list of IPs to be added or excluded
"ips": [
"203.133.166.33/32",
"211.249.200.134/32"
],
"ports": [
443
],
"updatedDate": "2023-06-28",
"addition": {
"ips": [
"111.111.111.0/32",
"111.111.111.1/32"
],
"date": "2023-06-30"
},
"exclusion": {
"ips": [
"203.133.166.33/32",
"211.249.200.134/32"
],
"date": "2023-07-01"
}
},
{
"service": "https://accounts.kakao.com", // If there is a list of IPs to be added
"ips": [
"211.231.99.67/32",
"110.76.142.110/32"
],
"ports": [
443
],
"updatedDate": "2023-06-28",
"addition": {
"ips": [
"111.111.111.2/32",
"111.111.111.3/32"
],
"date": "2023-06-30"
}
},
{
"service": "https://auth.kakao.com", // If there is a list of IPs to be excluded
"ips": [
"219.249.227.143/32",
"210.103.240.15/32",
"110.76.141.64/32"
],
"ports": [
443
],
"updatedDate": "2023-06-28",
"exclusion": {
"ips": [
"219.249.227.143/32",
"210.103.240.15/32"
],
"date": "2023-07-01"
}
},
...
],
"updatedDate": "2023-06-28"
}
HTTP/1.1 200 OK
{
"inbound": [
{
"service": "callback",
"ips": [
"211.249.203.104/24", "220.64.110.190/25", "220.64.111.158/25", "220.64.109.84/31", "203.217.230.3/26"
],
"ports": [443],
"updatedDate": "2023-06-28"
}, {
"service": "scrap",
"ips": [
"211.231.96.0/20", "27.0.236.0/22"
],
"ports": [
80, 443
],
"updatedDate": "2023-06-28"
}
],
"updatedDate": "2023-06-28"
}