ឯកសារ API

ឯកសារ API សម្រាប់ការស្វែងរកដែន WHOIS និង RDAP តាមរយៈកម្មវិធី៖ សួរទិន្នន័យការចុះឈ្មោះ វិភាគទម្រង់បញ្ចូលដែន និងរុករកដែនថ្មីៗ។

ការស្វែងរកដែន

URL ស្នើសុំ

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

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រប្រភេទតម្រូវឲ្យមានការពិពណ៌នា
domainstringបាទឈ្មោះដែនដែលត្រូវស្វែងរក (ឧទាហរណ៍, example.com)
force_refreshbooleanទេបង្ខំឲ្យធ្វើឲ្យស្រស់ទិន្នន័យដែលបានរក្សាទុក

ឧទាហរណ៍ចម្លើយ

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

Input ដែលមិនអាចចុះឈ្មោះបាន (subdomain, 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, subdomain, IDN, អក្សរតូចធំលាយគ្នា) ទៅជាទម្រង់ស្តង់ដារនៃដែនដែលអាចចុះឈ្មោះបានរបស់វា។ ការបញ្ចូល subdomain ត្រឡប់ 200 ជាមួយ is_registrable: false; មានតែអាសយដ្ឋាន IP, public suffix ដាច់ដោយឡែក និងទម្រង់ដែលមិនអាចវិភាគបានប៉ុណ្ណោះដែលត្រឡប់ 400។

URL ស្នើសុំ

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

ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រប្រភេទតម្រូវឲ្យមានការពិពណ៌នា
inputstringបាទទម្រង់បញ្ចូលដែនដើមគ្រប់ប្រភេទ (URL, subdomain, 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"
  }
}