API 文档

面向程序化 WHOIS 与 RDAP 域名查询的 API 文档：查询注册数据、解析域名输入并浏览最新域名。

域名查询

请求地址

GET https://whois.litelake.cn/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、子域名、国际化域名、大小写混合）规范化为可注册域名。子域名输入返回 200 及 is_registrable: false；仅 IP 地址、裸公共后缀和无法解析的输入返回 400。

请求地址

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

参数

参数	类型	必填	说明
input	string	是	任意形式的原始域名输入（URL、子域名、国际化域名、大小写混合）。返回规范化后的可注册域名。

响应示例

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