API 문서

프로그래밍용 WHOIS·RDAP 도메인 조회 API 문서: 등록 데이터, 입력 파싱, 최근 도메인 탐색.

도메인 조회

요청 URL

GET https://whois.litelake.com/api/public/whois?domain={domain}

매개변수

매개변수	타입	필수	설명
domain	string	예	조회할 도메인 이름 (예: example.com)
force_refresh	boolean	아니오	캐시된 데이터 강제 새로고침

응답 예시

{
  "code": 200,
  "message": "Query successful",
  "data": {
    "domain": "example.com",
    "tld": "com",
    "registrar": "Example Registrar, Inc.",
    "registry_domain_id": "123456789_DOMAIN_COM-VRSN",
    "created_date": "1995-08-14T04:00:00Z",
    "updated_date": "2023-08-14T04:00:00Z",
    "expiry_date": "2024-08-13T04:00:00Z",
    "status": ["clientTransferProhibited"],
    "name_servers": ["ns1.example.com", "ns2.example.com"],
    "query_count": 150,
    "last_queried_at": "2024-03-05T12:34:56Z"
  }
}

오류 응답

400 잘못된 요청

{
  "code": 400,
  "message": "Missing domain parameter"
}

등록할 수 없는 입력(서브도메인, URL)은 400 오류와 suggested_domain 수정 힌트를 반환합니다:

{
  "code": 400,
  "message": "invalid registrable domain: www.example.com, did you mean: example.com?",
  "data": {
    "input": "www.example.com",
    "suggested_domain": "example.com"
  }
}

404 찾을 수 없음

{
  "code": 404,
  "message": "Domain not found"
}

429 요청이 너무 많음

{
  "code": 429,
  "message": "Rate limit exceeded, please try again later"
}

500 내부 서버 오류

{
  "code": 500,
  "message": "Query failed, please try again later"
}

도메인 입력 파싱

URL, 서브도메인, IDN, 대소문자 혼용 등 모든 형태의 도메인 입력을 등록 가능한 도메인으로 정규화합니다. 서브도메인 입력은 is_registrable: false와 함께 200을 반환하고, IP 주소, 순수 퍼블릭 서픽스, 파싱할 수 없는 입력만 400을 반환합니다.

요청 URL

GET https://whois.litelake.com/api/public/domain/parse?input={input}

매개변수

매개변수	타입	필수	설명
input	string	예	URL, 서브도메인, IDN, 대소문자 혼용 등 모든 형식의 원시 도메인 입력입니다. 정규화된 등록 가능 도메인을 반환합니다.

응답 예시

{
  "code": 200,
  "message": "Parse successful",
  "data": {
    "input": "https://www.example.com/path?q=1",
    "domain": "example.com",
    "is_registrable": false
  }
}

오류 응답

400 잘못된 요청

{
  "code": 400,
  "message": "IP query is not supported: 1.2.3.4",
  "data": {
    "input": "1.2.3.4"
  }
}