한 줄 요청으로
현재 IP를 가져오세요.

GET STARTED

기본 엔드포인트

별도의 인증 없이 GET 요청으로 사용할 수 있습니다. JSON과 XML 응답은 CORS를 허용하므로 클라이언트에서 직접 호출할 수 있습니다.

JSON 응답 예시

{
    "result": true,
    "ip": "203.0.113.10",
    "version": "IPv4",
    "country_code": null,
    "country_name": {},
    "generated_at": "2026-10-01T00:00:00+00:00"
}

서버에 Cloudflare 국가 헤더나 GeoIP 모듈이 설정되어 있다면 country_code와 country_name이 함께 채워질 수 있습니다.

브라우저에서 호출하기

fetch('https://myip.aicodelab.co.kr/api/json/')
  .then(response => response.json())
  .then(data => console.log(data.ip));

API 응답 필드와 조회 범위

응답은 API를 호출한 연결을 기준으로 합니다. 서버에서 호출하면 호출 서버의 IP를 반환합니다. 로그인이나 API 키는 필요하지 않습니다.

result

요청 처리 성공 여부입니다.

ip

서버가 확인한 현재 요청의 IP 주소입니다.

version

주소 형식에 따라 IPv4 또는 IPv6를 반환합니다.

country_code

서버에 국가 정보가 설정된 경우 두 글자 국가 코드를 반환하며, 없으면 null입니다.

country_name

국가 정보가 있을 때 ko·en·ja 이름을 담으며, 없으면 빈 객체입니다.

generated_at

JSON 응답을 생성한 UTC 시각으로, ISO 8601 형식을 사용합니다.

위 필드는 JSON 응답 기준입니다. XML은 generated_at을 포함하지 않으며, 국가 정보가 없으면 빈 요소를 반환합니다. 위치 정보는 /api/geo/의 별도 조회이며, 일반 JSON 응답은 외부 GeoIP 조회를 수행하지 않습니다. 서버에 사설 IP만 보이면 HTTP 503과 result: false, ip: null을 반환합니다. 같은 공유기 안에서 접속할 때는 홈페이지의 브라우저 조회를 이용하세요. GET 요청을 사용하고 과도한 반복 호출은 피하세요.