مستندات API
مستندات API برای جستجوی دامنه بهصورت برنامهنویسی با WHOIS و RDAP: دریافت دادههای ثبت، تجزیه ورودی دامنه و مرور دامنههای اخیر.
جستجوی دامنه
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، حروف بزرگ و کوچک مخلوط) را به دامنه قابل ثبت نرمالسازی میکند. ورودیهای زیردامنه کد 200 همراه با is_registrable: false برمیگردانند؛ فقط آدرسهای 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"
}
}