개발자 API

공인 IP JSON API

요청자의 공인 IP만 간단하게 보고 싶으면 plain text 엔드포인트를 쓰고, ASN, 조직, 위치 문맥까지 함께 보고 싶으면 JSON 엔드포인트를 쓰면 됩니다.

API 미리보기

웹사이트, 설치 도구, 외부 서비스에서 바로 호출할 수 있는 공인 IP API입니다.

단순 IP 문자열부터 위치와 ASN이 포함된 JSON까지, RouterWiz 도구 화면과 외부 자동화에서 같은 데이터를 재사용할 수 있게 구성합니다.

  • GET /api/ip 는 plain text로 현재 공인 IP만 반환합니다.
  • GET /api/ip/json 은 ASN과 위치 문맥까지 함께 반환합니다.
  • CORS를 허용해 브라우저 위젯과 외부 대시보드에서도 바로 사용할 수 있습니다.
RouterWiz 공인 IP JSON API 이미지

엔드포인트

  • Plain text: https://routerwiz.com/api/ip
  • JSON: https://routerwiz.com/api/ip/json

두 엔드포인트 모두 GET 전용이고 Access-Control-Allow-Origin: *를 포함하므로 브라우저 JavaScript, 설치 페이지, 대시보드, 지원 도구에서 바로 호출할 수 있습니다.

예시: plain text

curl https://routerwiz.com/api/ip

예시: JSON

curl https://routerwiz.com/api/ip/json

{
  "result": true,
  "ip": "203.0.113.10",
  "ip_version": 4,
  "country_code": "KR",
  "country_name": {
    "en": "South Korea",
    "ko": "대한민국"
  },
  "continent_code": "AS",
  "continent_name": {
    "en": "Asia",
    "ko": "아시아"
  },
  "region": {
    "en": "Seoul",
    "ko": "서울"
  },
  "city": {
    "en": "Seoul",
    "ko": "서울"
  },
  "latitude": 37.5665,
  "longitude": 126.978,
  "asn": "4766",
  "organization": "Korea Telecom",
  "source": {
    "geo": "DB-IP Lite",
    "asn": "IPtoASN"
  },
  "observed_at_utc": "2026-05-06T09:40:15.9557479+00:00"
}

이 API가 잘 맞는 경우

  • 포트포워딩이나 DDNS 설정 전에 현재 공인 IP를 바로 보여주고 싶을 때
  • DDNS, NAT, 통신사, WAN 진단 흐름에 운영자 문맥을 붙이고 싶을 때
  • 대시보드, 설치 도구, 헬퍼 앱에 공인 IP 위젯을 간단하게 넣고 싶을 때

전체 API 목록도 필요할 때

RouterWiz는 공인 IP 엔드포인트 외에도 DNS, DDNS, 포트 체크, 공개 서비스 체크, 공유기 작업 흐름 보조 API를 같이 제공합니다.

RouterWiz API 도움말 보기