개발자 API

RouterWiz API 도움말

RouterWiz API는 공인 IP 확인, DNS와 DDNS 점검, 공개 경로 도달 여부, 공유기 로그인과 포트포워딩 흐름 보조까지 외부 서비스에서 재사용할 수 있도록 설계되어 있습니다.

API 문서 미리보기

RouterWiz API는 도구 결과를 외부 서비스에서도 재사용할 수 있게 엽니다.

공인 IP, DNS, DDNS, 포트 체크, 공개 서비스 검사, 공유기 작업 흐름 API를 한 문서 안에서 찾을 수 있게 정리합니다.

  • 웹 도구와 같은 백엔드를 사용합니다.
  • 외부 대시보드와 설치 도구에서 바로 호출할 수 있습니다.
  • 각 API는 예시 요청과 응답 해석을 함께 제공합니다.
RouterWiz API documentation visual

사용 규칙

  • 기본 주소: https://routerwiz.com
  • JSON 엔드포인트는 UTF-8 JSON을 반환하고 CORS에 Access-Control-Allow-Origin: *를 포함합니다.
  • 일부 엔드포인트는 Accept-Language: ko-KR 헤더를 보내면 안내 문구를 한국어로 반환합니다.
  • 포트 체크는 요청자의 공인 IP 경로만 대상으로 하며 제3자 임의 스캔은 허용하지 않습니다.
  • 호스트, URL, ping, traceroute, 서비스 체크 계열은 공개 대상만 허용하고 사설 LAN 주소는 차단합니다.

빠른 시작

  • 요청자의 공인 IP만 필요하면 GET /api/ip 를 쓰세요.
  • 공인 IP에 ASN과 위치 문맥까지 같이 보고 싶으면 GET /api/ip/json 을 쓰세요.
  • 호스트 해석, TCP 열림 여부, HTTP/HTTPS 응답을 한 번에 보고 싶으면 POST /api/tools/public-service-check 를 쓰세요.
  • 일반 네트워크 조회가 아니라 RouterWiz다운 작업 흐름 보조가 필요하면 POST /api/tools/port-forward-plan 과 POST /api/tools/router-login-route 를 쓰세요.

공인 IP와 IP 문맥

WAN 쪽 정체성과 운영자 문맥을 먼저 알아야 할 때 출발점으로 쓰는 API들입니다.

GET

공인 IP (plain text)

/api/ip

요청자의 공인 IP를 plain text로 반환합니다.

curl https://routerwiz.com/api/ip
  • 설치 페이지, 간단한 위젯, 쉘 스크립트에 붙이기 좋습니다.
  • JSON 래퍼 없이 IP 문자열만 반환합니다.

GET

공인 IP (JSON)

/api/ip/json

요청자의 공인 IP에 ASN과 위치 문맥을 같이 붙여 반환합니다.

curl https://routerwiz.com/api/ip/json
  • IP 버전, 국가, 대륙, 지역, 도시, 좌표, ASN, 조직 정보를 포함합니다.
  • 실시간 외부 조회 대신 서버 로컬 IP 데이터 파일을 우선 사용합니다.

POST

IP Lookup

/api/tools/ip-lookup

공개 IP의 ASN, prefix, registry, 사업자 문맥을 읽습니다.

curl -X POST https://routerwiz.com/api/tools/ip-lookup \
  -H "Content-Type: application/json" \
  -d '{"ip":"8.8.8.8"}'
  • NAT, DDNS, ISP, 호스팅 문맥을 볼 때 유용합니다.
  • 조직, prefix, registry, 국가, ASN 목록을 반환합니다.

POST

IP 위치 확인

/api/tools/ip-location

공개 IP의 위치 문맥을 확인합니다.

curl -X POST https://routerwiz.com/api/tools/ip-location \
  -H "Content-Type: application/json" \
  -d '{"ip":"8.8.8.8"}'
  • 국가, 지역, 도시, 시간대, 좌표, ASN, 조직을 가능한 범위에서 반환합니다.
  • WAN 경로와 운영자 문맥을 보는 데 좋습니다.

DNS와 DDNS

원격접속이 공인 IP가 아니라 호스트명에 기대고 있을 때 쓰는 API들입니다.

POST

DNS 조회

/api/tools/dns-lookup

호스트명의 A, AAAA, CNAME 레코드를 조회합니다.

curl -X POST https://routerwiz.com/api/tools/dns-lookup \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","recordType":"A"}'
  • DDNS, 공개 서비스, TLS 점검 전에 먼저 쓰기 좋습니다.
  • 정규화된 레코드 값과 다음 액션 힌트를 반환합니다.

POST

DNS 전파 확인

/api/tools/dns-propagation

같은 호스트명에 대해 여러 공개 리졸버 응답을 비교합니다.

curl -X POST https://routerwiz.com/api/tools/dns-propagation \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","recordType":"A"}'
  • 로컬 리졸버, Google Public DNS, Cloudflare DNS를 비교합니다.
  • DDNS와 전파 지연 진단에 유용합니다.

POST

Reverse DNS

/api/tools/reverse-dns

공개 IP의 PTR 호스트명을 읽습니다.

curl -X POST https://routerwiz.com/api/tools/reverse-dns \
  -H "Content-Type: application/json" \
  -d '{"ip":"8.8.8.8"}'
  • WAN 쪽 이름 문맥과 사업자 비교에 유용합니다.

POST

DDNS Match

/api/tools/ddns-match

현재 공인 IP 경로와 DDNS 호스트명 응답, 리졸버 전파 상태를 함께 비교합니다.

curl -X POST https://routerwiz.com/api/tools/ddns-match \
  -H "Content-Type: application/json" \
  -d '{"hostname":"example.ddns.net","recordType":"A"}'
  • 공인 IP, 직접 DNS 응답, 전파 비교, 최종 일치 판정을 반환합니다.
  • 포트포워딩 규칙에 시간을 더 쓰기 전에 먼저 확인하기 좋습니다.

도달 여부와 웹 응답

공개 경로가 열려 있는지, 그 위에서 웹 서비스가 실제로 응답하는지 보는 API들입니다.

POST

포트 체크

/api/tools/port-check

요청자의 공인 IP에서 TCP 포트가 열려 보이는지 확인합니다.

curl -X POST https://routerwiz.com/api/tools/port-check \
  -H "Content-Type: application/json" \
  -d '{"port":25565,"protocol":"tcp"}'
  • 임의 제3자 IP는 검사하지 않습니다.
  • open, closed, timeout, refused, error와 다음 액션 힌트를 반환합니다.

POST

공개 서비스 체크

/api/tools/public-service-check

공개 호스트 해석, TCP 도달 여부, HTTP/HTTPS 응답을 한 요청에 묶어서 봅니다.

curl -X POST https://routerwiz.com/api/tools/public-service-check \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com","port":443,"protocol":"tcp","scheme":"https"}'
  • 홈서버, NAS, DDNS 호스트명, 공개 웹 엔드포인트 확인에 유용합니다.
  • 해석된 IP, TCP 결과, HTTP/HTTPS 응답, 다음 액션을 한 번에 반환합니다.

POST

Ping

/api/tools/ping

공개 대상에 대해 ICMP 도달 여부를 확인합니다.

curl -X POST https://routerwiz.com/api/tools/ping \
  -H "Content-Type: application/json" \
  -d '{"host":"example.com"}'
  • 애플리케이션 레벨 증명이 아니라 경로 단서를 보는 용도입니다.

POST

Traceroute

/api/tools/traceroute

공개 경로 초반 hop을 따라갑니다.

curl -X POST https://routerwiz.com/api/tools/traceroute \
  -H "Content-Type: application/json" \
  -d '{"host":"example.com"}'
  • 단일 ping보다 더 깊은 경로 문맥이 필요할 때 유용합니다.

POST

HTTP 헤더 확인

/api/tools/http-headers

공개 URL의 헤더, 리다이렉트, 상태 코드를 확인합니다.

curl -X POST https://routerwiz.com/api/tools/http-headers \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
  • 공개 서비스가 열려 있지만 웹 동작이 이상할 때 유용합니다.

POST

SSL 확인

/api/tools/ssl-check

TLS 인증서 유효기간, 발급자, 프로토콜 정보를 확인합니다.

curl -X POST https://routerwiz.com/api/tools/ssl-check \
  -H "Content-Type: application/json" \
  -d '{"host":"example.com","port":443}'
  • HTTPS 응답이 확인된 직후 이어서 보기 좋습니다.

공유기 작업 흐름 보조

일반 네트워크 조회보다 한 단계 더 RouterWiz다운 작업 흐름 보조를 하는 API들입니다.

POST

포트포워딩 계획 생성

/api/tools/port-forward-plan

Minecraft, RDP, CCTV, NAS 같은 대표 사용 사례에 맞는 공유기 입력값을 만듭니다.

curl -X POST https://routerwiz.com/api/tools/port-forward-plan \
  -H "Content-Type: application/json" \
  -d '{"useCase":"minecraft","routerBrand":"iptime","internalIp":"192.168.0.34"}'
  • 서비스명, 프로토콜, 포트, 메뉴 경로, 보안 주의사항, 다음 액션을 반환합니다.

POST

공유기 로그인 경로 추정

/api/tools/router-login-route

통신사 장비와 개인 공유기가 함께 있을 수 있을 때, 어느 장비부터 로그인해야 하는지 경로를 제안합니다.

curl -X POST https://routerwiz.com/api/tools/router-login-route \
  -H "Content-Type: application/json" \
  -d '{"routerBrand":"kt","gateway":"172.30.1.254","platform":"windows","connectionState":"yes"}'
  • route targets, 체크리스트, 스티커 힌트, 경고, 다음 액션을 반환합니다.
  • 가이드형 로그인 흐름과 Browser Assist handoff에 유용합니다.