Watch-IP 데이터 소스 및 커버리지
Watch-IP 응답의 모든 필드는 엔드포인트에 따라 두 가지 소스 중 하나에서 나옵니다: 접속한 브라우저에 대한 자체 네트워크 수준 데이터(GET /v1/geo), 또는 제공된 IP 주소에 대한 타사 DB-IP City Lite 및 ASN Lite 데이터베이스(GET/POST /v1/lookup). 두 엔드포인트 모두 각 소스가 제공하는 위치로부터 동일한 통화/컴플라이언스/로케일/일출·일몰/공휴일/연령/세금 필드를 계산합니다. 이메일 검사에는 아래에 설명된 자체 소스가 있습니다. 이 페이지는 어떤 소스가 어떤 필드를 뒷받침하는지, 무엇이 빠져 있는지, 오류로 의심되는 사항을 어떻게 보고하는지 안내합니다 — 두 소스를 직접 평가하는 방법은 정확도를 참고하세요.
GET /v1/geo: 네트워크 수준 데이터와 로컬 보강 정보
country, region, regionCode, city, latitude, longitude, continent, postalCode, timezone, asn, asOrganization은 접속한 클라이언트에 대한 자체 요청 수준 네트워크 데이터에서 가져옵니다 — Watch-IP가 별도로 유지하는 데이터베이스가 아니라 매 요청마다 새로 읽습니다. currency, callingCode, locale, sun(일출/일몰), holiday, age, tax, compliance 필드는 해당 위치와 API에 포함된 유지 관리되는 참조 테이블을 바탕으로 로컬에서 계산됩니다 — 방문자에 대해 독립적으로 관찰된 사실이 아니라 지역적 힌트입니다. security(VPN/Tor/데이터센터/위협/제재 대상 네트워크 지표)는 아래 설명하는 목록 데이터와 대조되며, 이를 포함하는 요금제에서만 표시됩니다.
GET/POST /v1/lookup: DB-IP City Lite
제공된 주소에 대한 ip, found, country, continent, region, city, latitude, longitude는 DB-IP의 City Lite 데이터베이스에서 가져옵니다. 이 엔드포인트에서는 postalCode와 timezone이 항상 null입니다 — City Lite는 이를 채우지 않습니다 — 그리고 asn/asOrganization/security는 조회 응답에 전혀 포함되지 않습니다. found: false는 현재 로드된 데이터베이스에 해당 주소와 일치하는 레코드가 없다는 의미입니다. 동일한 구현이 데이터베이스 자체를 사용할 수 없거나 로드가 완료되지 않은 경우에도 found: false를 반환할 수 있으므로, false를 "사용할 수 있는 결과 없음"으로 취급하고 해당 주소에 실제 위치가 없다는 증거로 취급하지 마세요.
- 소스
- DB-IP(db-ip.com) — City Lite 에디션.
- 저작권 표시
- IP Geolocation by DB-IP(db-ip.com), 이 에디션에 대한 DB-IP의 라이선스 조건에 따름.
- 업데이트 주기
- DB-IP의 City Lite 자체 릴리스 일정에 따라 정해집니다. Watch-IP는 레코드별 최신성을 개별적으로 검증하지 않습니다.
보안 목록 커버리지는 네트워크 유형과 IP 버전에 따라 다릅니다
isTor, isVpn, isDatacenter, isThreat, isSanctionedNetwork 필드는 별도로 유지 관리되는 목록과 대조되며, 자체 네트워크 수준 데이터나 DB-IP에서 파생되지 않습니다. IPv4 연결은 다섯 가지 카테고리 모두에 대해 확인됩니다. IPv6 연결은 Tor를 제외한 모든 카테고리에 대해 확인됩니다 — 현재 무료 IPv6 Tor 출구 목록 소스가 없기 때문입니다. 실제로 Tor 출구인지 여부와 관계없이 IPv6 연결의 isTor는 항상 false입니다. 이 목록들은 자체 스토리지에 컴파일 및 저장되며 일정에 따라 갱신됩니다. 갱신이 느리거나 실패하면 오류 응답 대신 오래되었거나 비어 있는 목록 데이터로 저하되므로, false 결과는 "현재 로드된 목록에 일치 항목 없음"을 의미할 뿐 검증된 안전한 연결을 의미하지 않습니다.
이메일 검사: 일회용 도메인 목록, DNS, 등록 데이터
isDisposable은 커뮤니티가 관리하는 세 가지 오픈 소스 일회용 도메인 목록을 병합해 몇 시간마다 갱신한 목록과 비교하며, 상위 소스의 잘못된 항목이 주요 메일함 제공자와 기업 도메인을 표시하지 못하도록 내장 허용 목록을 제외합니다. 목록에 있는 도메인의 하위 도메인도 일치합니다. disposableSource: mx_host는 목록에 있는 도메인이 어떤 메일 서버를 사용하는지에 대한 Watch-IP 자체 관찰에서 나옵니다 — 목록에 있는 여러 도메인을 처리하고 공유 메일 제공자가 아닌 메일 호스트는 일회용으로 취급됩니다. mx는 최대 하루 동안 캐시되는 실시간 DNS 조회(DNS-over-HTTPS)이며, 실패하거나 느린 조회는 추측하지 않고 unknown으로 보고됩니다. isFreeProvider, isRoleAccount, didYouMean은 Watch-IP가 관리하는 선별된 테이블에서 나옵니다. emailDomainAgeDays(가입 검사 전용)는 RDAP를 통한 공개 도메인 등록 데이터에서 나오며, 7일간 캐시되고, 레지스트리가 공개하지 않는 경우 null입니다. 개별 메일함에 대해서는 어떤 소스도 조회하지 않습니다.
- disposable-email-domains
- github.com/disposable-email-domains/disposable-email-domains — CC0 / 퍼블릭 도메인.
- disposable/disposable-email-domains
- github.com/disposable/disposable-email-domains — MIT 라이선스.
- FakeFilter
- github.com/7c/fakefilter — BSD-3-Clause 라이선스.
- 업데이트 주기
- 목록은 몇 시간마다 다시 가져옵니다. 상위 소스 다운로드가 실패하거나 잘린 경우 목록을 줄이지 않고 마지막 정상 목록을 유지합니다.
관찰된 값과 계산된 값
country/region/city/좌표/ASN은 해당 특정 요청이나 주소에 대해 자체 네트워크 수준 데이터 또는 DB-IP의 데이터베이스에서 직접 읽은, 관찰된 값에 가장 가까운 값으로 취급하세요. currency, calling code, locale, 일출/일몰, holiday, age, tax, compliance 필드는 해당 위치와 정적 참조 테이블에서 파생된 계산된 힌트로 취급하세요 — 기본값으로는 유용하지만, 연결 반대편에 있는 사람에 대한 독립적으로 검증된 사실은 아닙니다.
의심되는 오류를 발견한 경우
구체적인 IP나 요청, 그리고 예상했던 내용과 함께 문의해 주세요 — 이 페이지에 설명된 알려진 제약 사항인지, 오래된 목록 항목인지, DB-IP에 후속 확인이 필요한 사항인지 확인해 드립니다. Watch-IP는 DB-IP의 기본 데이터베이스를 제어하지 않으며 그에 대한 수정 일정을 보장할 수 없지만, 이렇게 제기된 문제를 추적하고 결과를 알려드립니다.
관련 페이지
- GET /v1/geo 레퍼런스방문자 지오로케이션 엔드포인트의 전체 필드 레퍼런스.
- GET /v1/lookup/:ip 레퍼런스임의 IP 조회 엔드포인트의 전체 필드 레퍼런스.
- POST /v1/lookup 레퍼런스배치 IP 조회 엔드포인트의 전체 필드 레퍼런스.
- 이메일 검사 API 레퍼런스단일 검사, 일괄 검사, 목록 작업, 가입 검사 이메일 엔드포인트의 필드, 판정, 사유 코드.
- POST /v1/risk/check 레퍼런스비정상 이동 탐지 엔드포인트의 전체 필드 레퍼런스.
- IP 지오로케이션 정확도IP 지오로케이션이 알려줄 수 있는 것과 없는 것, 그리고 직접 평가하는 방법.
- 문의하기Watch-IP 지원팀 또는 영업팀에 연락하세요.