개발가이드

  • 개발가이드

도메인/IP 위치 조회

도메인 또는 IP의 위치 정보를 조회합니다.

정보

Method
URL
POST
https://apick.app/rest/location

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
address
String
O
검색할 도메인 또는 IP

응답

본 API는 MaxMind GeoIP2 데이터를 기반으로 합니다. code(행정구역 코드)와 r3(동)는 항상 빈 값("")으로 반환되며, r1/r2 등 지명은 한글이 아닌 영문으로 제공됩니다(예: "서울특별시" → "Seoul"). net(ISP)은 IP에 따라 비어있을 수 있습니다.

Body
이름
타입
설명
data
Object
조회 데이터
geo
Object
위치 정보
country
String
국가 코드 (ISO, 예: KR)
code
String
행정구역 코드 (미지원, 항상 빈 값)
r1
String
시/도 (영문, 예: Seoul)
r2
String
시/군/구 (영문, 예: Geumcheon-gu)
r3
String
동 (미지원, 항상 빈 값)
lat
Double
위도
long
Double
경도
net
String
ISP/조직명 (IP에 따라 빈 값일 수 있음)
ip
String
IP 주소
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/location" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "address=apick.app"
응답 예시

{
    "data": {
        "geo": {
            "country": "KR",
            "code": "",
            "r1": "Seoul",
            "r2": "Geumcheon-gu",
            "r3": "",
            "lat": 37.4784,
            "long": 126.8982,
            "net": "KT"
        },
        "ip": "121.140.146.38",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 30,
        "pl_id": 1595641,
        "ms": 517
    }
}

API 호출

요청
Key
Value
address
응답
현재 페이지 북마크