개발자 API
RouterWiz API 도움말
RouterWiz API는 공인 IP 확인, DNS와 DDNS 점검, 공개 경로 도달 여부, 공유기 로그인과 포트포워딩 흐름 보조까지 외부 서비스에서 재사용할 수 있도록 설계되어 있습니다.
API 문서 미리보기
RouterWiz API는 도구 결과를 외부 서비스에서도 재사용할 수 있게 엽니다.
공인 IP, DNS, DDNS, 포트 체크, 공개 서비스 검사, 공유기 작업 흐름 API를 한 문서 안에서 찾을 수 있게 정리합니다.
- 웹 도구와 같은 백엔드를 사용합니다.
- 외부 대시보드와 설치 도구에서 바로 호출할 수 있습니다.
- 각 API는 예시 요청과 응답 해석을 함께 제공합니다.

관련 이미지로 이해하기
이 페이지에서 함께 보면 좋은 장면



사용 규칙
- 기본 주소: 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-checkTLS 인증서 유효기간, 발급자, 프로토콜 정보를 확인합니다.
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-planMinecraft, 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에 유용합니다.
