페이지 이동경로
  • Docs>
  • Reference Information>
  • Utility API

Reference Information

Utility API

This document provides the Utility API information for Kakao API platform users.

Retrieve Kakao IP list

Basic information
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.

Kakao service information
유형 설명
Inbound Required IPs to get the request from Kakao.
One of the request types below.
callback: Callback
scrap: 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 API
https://kapi.kakao.com: Kakao API
https://accounts.kakao.com: Kakao Account
https://auth.kakao.com: Kakao Account(Mobile)
https://dapi.kakao.com: Daum search, local API
https://apps.kakao.com: Kakao Talk Message API
https://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.

Request

Header
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
Query parameter
Name Type Description Required
rule_type String IP type to retrieve.
One of inbound and outbound.
X

Response

Body
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
ServiceIp
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
IpChange
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

Sample

Request
curl -v -X GET "https://kapi.kakao.com/v1/system/ips" \
  -H "Authorization: KakaoAK ${REST_API_KEY}"
Request: retrieve only inbound IP list
curl -v -G GET "https://kapi.kakao.com/v1/system/ips" \
  -H "Authorization: KakaoAK ${REST_API_KEY}" \
  -d "rule_type=inbound"
Response
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"
}
Response: If only the inbound IP list is requested
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"
}
Reference Information> Utility API