Tài liệu API

Tài liệu API cho tra cứu WHOIS và RDAP tên miền theo chương trình: truy vấn dữ liệu đăng ký, phân tích đầu vào tên miền và duyệt các tên miền gần đây.

Tra cứu Tên miền

URL Yêu cầu

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

Tham số

Tham sốKiểuBắt buộcMô tả
domainstringCóTên miền cần tra cứu (ví dụ: example.com)
force_refreshbooleanKhôngBuộc làm mới dữ liệu được lưu trong bộ nhớ đệm

Ví dụ phản hồi

{
  "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"
  }
}

Phản hồi lỗi

400 Yêu cầu không hợp lệ

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

Đầu vào không thể đăng ký (tên miền phụ, URL) sẽ trả về 400 kèm gợi ý chỉnh sửa 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 Không tìm thấy

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

429 Quá nhiều yêu cầu

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

500 Lỗi máy chủ nội bộ

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

Phân tích Đầu vào Tên miền

Chuẩn hóa mọi dạng đầu vào tên miền (URL, tên miền phụ, IDN, chữ hoa thường lẫn lộn) về tên miền có thể đăng ký của nó. Đầu vào dạng tên miền phụ trả về 200 với is_registrable: false; chỉ địa chỉ IP, hậu tố công khai trần và đầu vào không thể phân tích mới trả về 400.

URL Yêu cầu

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

Tham số

Tham sốKiểuBắt buộcMô tả
inputstringCóĐầu vào tên miền thô ở bất kỳ dạng nào (URL, tên miền phụ, IDN, chữ hoa thường lẫn lộn). Trả về tên miền có thể đăng ký đã được chuẩn hóa.

Ví dụ phản hồi

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

Phản hồi lỗi

400 Yêu cầu không hợp lệ

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