문서 — IPRapid

API

HTTP 및 JSON API

인증 불필요

핵심 엔드포인트에는 계정이나 쿠키가 필요하지 않습니다. 동적 응답은 Cache-Control: no-store 및 요청 제한 헤더를 사용합니다.

API v1

안정적인 JSON

안정적인 응답 계약을 제공하는 현재 및 대상 조회용 버전 지정 snake_case JSON입니다.

GET/api/v1/self

네트워크, 위치 및 ASN 필드를 포함한 현재 IP의 구조화된 결과입니다.

curl --fail --silent --show-error https://iprapid.com/api/v1/self

GET/api/v1/lookup/{ip}

검증된 IPv4 또는 IPv6 주소의 구조화된 조회 결과입니다.

curl --fail --silent --show-error https://iprapid.com/api/v1/lookup/8.8.8.8

GET/api/v1/meta

schema_version · capabilities · fields

curl --fail --silent --show-error https://iprapid.com/api/v1/meta

JSON

호환성

경로	응답
`GET /`	콘텐츠 협상 루트: CLI와 /에는 JSON, text/plain에는 단일 IP, 명시적 text/html 요청에는 SSR 페이지를 반환합니다.
`GET /json`	네트워크, 위치 및 ASN 필드를 포함한 현재 IP의 구조화된 결과입니다.
`GET /json/{ip}`	검증된 IPv4 또는 IPv6 주소의 구조화된 조회 결과입니다.
`GET /ip/{ip}`	기계 클라이언트에는 정규화된 대상 IP를, 명시적 HTML 요청에는 noindex 조회 페이지를 반환합니다.

curl -sS https://iprapid.com/json
curl -sS https://iprapid.com/json/8.8.8.8

터미널

TEXT / ANSI

경로	응답
`GET /ip`	정규화된 현재 IP 뒤에 줄바꿈 하나를 반환합니다.
`GET /info[/{ip}]`	안정된 레이블과 순서를 사용하며 ANSI 제어 문자가 없는 상세 UTF-8 일반 텍스트입니다.
`GET /ansi[/{ip}]`	/info 보기에 명시적으로 허용된 SGR 색상을 적용합니다.
`GET /field/{field}[/{ip}]`	허용된 단일 값과 줄바꿈을 반환하며 값이 없으면 204입니다.

curl iprapid.com
curl -4 iprapid.com
curl -6 iprapid.com

curl.exe iprapid.com
curl.exe -4 iprapid.com
curl.exe -6 iprapid.com

API v1 · JSON

APPLICATION/JSON

{
  "schema_version": "1",
  "query": {
    "type": "lookup",
    "ip": "8.8.8.8",
    "ip_version": 4
  },
  "network": {
    "asn": 15169,
    "as_organization": "Google LLC"
  },
  "location": {
    "continent_code": "NA",
    "country_code": "US",
    "country": "United States",
    "region_code": null,
    "region": null,
    "city": null,
    "postal_code": null,
    "timezone": "America/Chicago",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822,
      "accuracy_radius_km": 1000
    }
  },
  "data": {
    "status": "available",
    "built_at": "2026-03-03T08:15:43Z"
  },
  "observed_at": "2026-07-25T12:23:07Z"
}

측정 방법과 신호의 경계

이 서비스는 서버가 관측한 네트워크 정보, 로컬 지리 데이터와 브라우저 측 증거를 분리하여 서로 다른 신호를 혼동하지 않습니다.

표시되는 공인 IP는 이 HTTP 연결에서 서비스가 관측한 주소입니다.
국가, 지역, 도시, 시간대, 좌표, ASN 및 조직 정보는 로컬 데이터셋에서 가져옵니다.
WebRTC, DNS, 언어, 시간대 및 IPv6 검사는 브라우저에서 각각 독립적으로 관측됩니다.
사용 불가, 알 수 없음, 관측 없음과 불일치는 서로 다른 상태입니다.

정확도와 데이터 최신성

IP 위치 정보는 기기나 가구가 아닌 네트워크 할당을 나타냅니다. 도시와 좌표는 실제 위치와 멀 수 있으며 정확도 반경은 보장이 아닌 불확실성 추정치입니다.

개인정보 보호 및 보존

조회 경로는 원시 IP, URI, 헤더 또는 지문을 PostgreSQL 집계에 저장하지 않습니다. 서명된 공유 링크는 축약된 상태만 포함하며 24시간 후 만료되고 공유 레코드로 저장되지 않습니다.

자주 묻는 질문

표시된 도시가 제 정확한 위치인가요?

아니요. IP 위치 정보는 네트워크 수준의 근사치입니다. 정확도 반경을 확인하고 기기나 주소의 정확한 위치로 간주하지 마세요.

이 서비스가 제 IP 조회를 데이터베이스에 저장하나요?

애플리케이션은 사용량 집계에 원시 IP 주소를 저장하지 않습니다. 제한된 웹 접근 로그는 별도 정책으로 관리됩니다.

IPv6가 사용 불가가 아니라 알 수 없음으로 표시되는 이유는 무엇인가요?

설정되지 않았거나 차단되거나 불확실한 측정만으로 IPv6가 없다고 증명할 수 없으므로 명확한 결과 전까지 알 수 없음으로 유지됩니다.

진단 공유 링크에는 무엇이 포함되나요?

축약된 상태 값, 발행 및 만료 시간, 서명만 포함합니다. IP 주소, 좌표 또는 DNS 리졸버 주소는 포함하지 않습니다.