호출자 위치 가져오기

IP 주소를 기준으로 사용자의 지리적 위치를 조회합니다.

이 API는 디버깅 목적을 위해 제공되며, 향후 제공이 중단될 수 있습니다.

GET /geolocate

호출자 위치 가져오기

cURL

curl --request GET \
  --url https://api.example.com/geolocate

200

{
  "ip": "<string>",
  "location": {
    "file_index": 123,
    "range_start_int": 123,
    "range_end_int": 123,
    "range_start_ip": "<string>",
    "range_end_ip": "<string>",
    "country_code": "<string>",
    "country_name": "<string>"
  },
  "allowed": false
}

쿼리 매개변수

ip · string | null

지리적 위치를 조회할 IP 주소입니다. 지정하지 않으면 클라이언트의 IP 주소가 사용됩니다. 지리적 위치 확인에 사용할 IP 주소입니다. 기본값은 클라이언트 IP 주소입니다.

예시:

"1.2.3.4"

응답

200

application/json

성공 응답

ip · string · 필수

해석된 IP 주소로, 디버깅에 유용합니다.

location · Geolocation · object

IP 주소 위치에 대한 정보입니다. 위치를 확인할 수 없는 경우 None입니다.

표시 하위 속성

allowed · boolean · 기본값: false

이 IP 주소를 추론(inference)에 사용할 수 있는지 여부입니다.