מסמכי 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"
}
}