وثائق API
وثائق API لعمليات بحث WHOIS وRDAP للنطاقات برمجيًا: استعلم عن بيانات التسجيل وحلّل مدخلات النطاقات وتصفّح النطاقات المضافة مؤخرًا.
بحث النطاق
رابط الطلب
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.
رابط الطلب
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"
}
}