/api/ip용 IP 조회 API 가이드

이 가이드를 사용해 /api/ip에 단일 IP 조회 요청을 보내고, 반환되는 JSON 필드를 이해한 다음, 더 많은 컨텍스트가 필요할 때 실제 브라우저 워크플로우로 전환하세요.

범위를 사실에 맞게 유지하세요. /api/ip는 한 번에 공인 IP 하나를 위한 조회 도우미입니다. 대량 조회, 인증 또는 SLA 보장을 제공하는 API 제품이 아닙니다.

Open IP lookup 네트워크/보안 허브로 돌아가기
이럴 때 사용하세요
공인 IP 단일 조회의 JSON 출력이 필요하고, fetch나 CLI 호출을 자동화하기 전에 정확한 요청 패턴을 알아야 합니다.
현재 규약
/api/ip는 ip 쿼리 매개변수가 필요하며, 한 번에 공인 IP 하나에 대한 JSON 소유권 컨텍스트를 반환합니다.
가드레일
유효하지 않거나 사설/예약된 입력은 오류 JSON을 반환합니다. 이 엔드포인트는 대량 조회, 인증 또는 가동 시간 보장을 약속하지 않습니다.
예제 요청 및 응답
브라우저 fetch 예제
프런트엔드나 디버깅 스크립트에서 브라우저 조회와 같은 ASN 및 네트워크 컨텍스트가 필요할 때는 간단한 GET 요청을 사용하세요. 
fetch("/api/ip?ip=8.8.8.8")
  .then((response) => response.json())
  .then((data) => console.log(data));
CLI curl 예제
일반 텍스트 /ip 터미널 바로가기 대신 JSON이 필요할 때는 ip 쿼리 매개변수를 명시적으로 보내세요. 
curl https://comutil.com/api/ip?ip=8.8.8.8
응답 필드 예시
실제 엔드포인트는 현재 RDAP 및 WHOIS 조회 흐름에서 가져온 중첩된 network 객체와 함께 최상위 ASN 메타데이터를 반환합니다. 
{
  "asn_registry": "arin",
  "asn": "15169",
  "asn_cidr": "8.8.8.0/24",
  "asn_country_code": "US",
  "asn_date": "1992-12-01",
  "asn_description": "GOOGLE, US",
  "network": {
    "name": "GOGL",
    "country": "US",
    "start_address": "8.8.8.0",
    "end_address": "8.8.8.255",
    "type": "DIRECT ALLOCATION",
    "status": "active",
    "links": []
  },
  "nir_postal_code": null,
  "nir_range": null,
  "address": "1600 Amphitheatre Parkway",
  "email_admin": "arin-contact@google.com",
  "email_tech": null
}
먼저 볼 응답 필드

주소나 연락처 세부 정보를 해석하기 전에 소유권과 범위를 설명하는 필드부터 확인하세요.

  • asn_registry, asn, asn_description은 현재 보고 있는 레지스트리와 운영 주체를 알려줍니다.
  • network.start_address, network.end_address, network.status는 해당 할당의 가시 범위와 수명 주기 컨텍스트를 보여줍니다.
  • address, email_admin, email_tech는 에스컬레이션 메모에 도움이 될 수 있지만, 1차 판단의 첫 신호라기보다는 보조 정보입니다.
오류 처리 범위

다음은 실제 엔드포인트의 현재 제약 사항이므로 자동화도 이에 맞춰 유지하세요.

  • ip가 없으면 {"error": "IP address is required."}가 반환됩니다.
  • 사설 또는 예약 주소는 공개 소유권 데이터 대신 오류 JSON을 반환합니다.
  • 잘못된 형식의 입력은 유효하지 않은 IP 형식을 설명하는 오류 JSON을 반환합니다.
API 문서를 벗어나야 할 때

규약을 이해하려면 문서 경로를 사용하고, 더 풍부한 조사 컨텍스트나 공유 가능한 조회 페이지가 필요할 때는 실제 브라우저 워크플로우로 이동하세요.

  • 같은 조회에 대한 브라우저 UI, 공유 URL, 지도, 조사 요약이 필요하면 /ip를 여세요.
  • JSON 필드뿐 아니라 워크플로우 맥락이 필요하면 IP 및 ASN 가이드를 읽으세요.
  • 질문이 도메인 소유권이나 CIDR 범위로 확장되면 네트워크/보안 허브로 돌아가세요.
실제 조사 워크플로우 이어가기
IP 및 ASN 가이드
같은 소유권 데이터를 두고 워크플로우 해석이 필요하면 조사 중심 가이드를 읽으세요.
조사 워크플로우
조회가 실제 트리아지 흐름으로 이어지면 더 넓은 도메인 -> IP -> CIDR 순서를 따르세요.
네트워크/보안 허브
빠른 시작 카드와 더 넓은 조사 결정 스트립을 보려면 허브로 돌아가세요.
WHOIS와 RDAP 비교 가이드
실제 IP 워크플로우가 구조화된 레지스트리 소유권 데이터를 보여주는 이유를 설명해야 할 때는 프로토콜 비교를 사용하세요.