Mga Dokumento sa API

Dokumentasyon sa API alang sa programmatic WHOIS ug RDAP lookups: kuhaa ang datos sa pagrehistro, i-parse ang domain input, tan-awa bag-ong mga domain.

Pagpangita sa Domain

URL sa Pangutana

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

Mga Parameter

Parameter	Tipo	Gikinahanglan	Paghubit
domain	string	Oo	Domain name nga pangitaon (pananglitan, example.com)
force_refresh	boolean	Dili	Pugsa ang pag-refresh sa cached nga datos

Pananglitan sa Tubag

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

Tubag nga Sayop

400 Dili Maayo nga Pangutana

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

Ang dili marehistro nga input (subdomain, URL) moresulta ug 400 uban sa suggested_domain correction hint:

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

404 Wala Makita

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

429 Daghang Mga Pangutana

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

500 Sayop sa Internal Server

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

Pag-parse sa Domain Input

I-normalize ang bisan unsang porma sa domain input (URL, subdomain, IDN, mixed case) ngadto sa registrable domain niini. Ang subdomain inputs mo-return ug 200 uban ang is_registrable: false; ang IP addresses lamang, bare public suffixes, ug dili ma-parse nga input ang mo-return ug 400.

URL sa Pangutana

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

Mga Parameter

Parameter	Tipo	Gikinahanglan	Paghubit
input	string	Oo	Raw nga domain input sa bisan unsang porma (URL, subdomain, IDN, mixed case). Mobalik sa normalized nga registrable domain.

Pananglitan sa Tubag

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

Tubag nga Sayop

400 Dili Maayo nga Pangutana

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