API
תיעוד v1 API
מידע על שיטות נתמכות, פרמטרים, נתונים שהוחזרו ודוגמאות.
אזהרה: ה-API נמצא כעת בפיתוח וכפוף לשינויים. שיטות, פרמטרים ותכונות חדשים עשויים להתווסף בעתיד. כל השינויים שיבוצעו יישארו תואמים לאחור עם הפונקציונליות הקיימת.
סקירה
ניתן להשתמש ב- API של TLD-List v1 כדי לאחזר נתונים המוצגים ב- TLD-List ממסד הנתונים החי שלו.
ה- API מקבל ומחזיר נתונים מקודדים של JSON באמצעות HTTP POSTs. דרישות עבור כל בקשות השיטה של API:
- בקשות חייבות להתבצע באמצעות שיטת HTTP POST
- בקשות חייבות לכלול גוף JSON המכיל זוג מפתחות API ציבורי ופרטי חוקי לאימות
- בקשות חייבות לכלול את הכותרת:
Content-Type: application/json
פרמטרים מועברים ל- API כמפתח/ערכים בגוף הבקשה המקודד JSON.
כתובת ה- URL המשמשת כבסיס עבור כל בקשות ה- API היא:https://api.tld-list.com/v1
אימות
האימות מתבצע על-ידי העברת מפתח API ציבורי ומפתח API פרטי בגוף JSON המוצב בכתובת ה- URL של השיטה. כל שיחות ה- API חייבות לכלול צירוף מפתחות API חוקי. ניתן ליצור צמדי מפתחות API בחשבון TLD-List שלך תחת לשונית API .
בקר בדף Account > API כדי ליצור מפתחות API.
מפתחות API מועברים בגוף הבקשה JSON באמצעות הפרמטרים apiKeyPublic (המפתח הציבורי שלך) ו- apiKeyPrivate (המפתח הפרטי שלך).
Example authentication parameters
'{'
\"apiKeyPublic\":\"MY_PUBLIC_KEY\",
\"apiKeyPrivate\":\"MY_PRIVATE_KEY\"
'}'תגובה
כל תגובות ה- API המוצלחות יכללו 200 SUCCESS קוד מצב HTTP וגוף מקודד JSON. כל קוד מצב HTTP אחר בתגובה מציין שהבקשה נכשלה ואירעה שגיאה.
כל אובייקט התגובה JSON שיוחזר על-ידי ה- API יכלול את המבנה הבא:
| מפתח | סוג | תיאור |
|---|---|---|
status | string | מציין את מצב הבקשה. SUCCESS מציין ששיחת ה- API בוצעה בהצלחה, FAIL מציין שהבקשה נכשלה. |
errors | array of objects | מערך של אובייקטים המייצגים את השגיאות שאירעו. כל אובייקט שגיאה יכיל:codeמחרוזת המזהה את סוג השגיאה:messageמחרוזת הניתנת לקריאה על-ידי בני אדם המתארת את השגיאה:parameterמחרוזת אופציונלית המציינת בעיה בפרמטר מסוים שהועבר בבקשה.:אם לא אירעו שגיאות, המערך errors יהיה ריק. |
seconds | number | משך הזמן שלקח לשרת ה- API ליצור תגובה (בשניות). |
data | string|array|object | אובייקט, מערך או מחרוזת המכילים את הנתונים המבוקשים. |
דוגמה לאובייקט תגובה שנכשל שנכשל עם שגיאות
'{'
\"errors\" : [
'{'
\"code\" : \"PARAMETER_INVALID\",
\"message\" : \"pricetypes parameter must be a non-empty array\",
\"parameter\" : \"pricetypes\"
'}',
'{'
\"code\" : \"PARAMETER_INVALID\",
\"message\" : \"includeRegistrars parameter contains invalid registrar names: foobar\",
\"parameter\" : \"includeRegistrars\"
'}'
],
\"seconds\" : 0.001,
\"status\" : \"FAIL\"
'}'דוגמה לאובייקט תגובה מוצלחת
'{'
\"data\" : [
'{'
\"cheapest\" : '{'
\"renewal\" : [
'{'
\"id\" : \"sav\",
\"name\" : \"Sav\",
\"price\" : \"8.38\"
'}'
],
'}',
\"currency\" : \"USD\",
\"name\" : \"com\",
\"registrarsIncluded\" : 58,
\"registrarsTotal\" : 58
'}'
],
\"errors\" : [],
\"seconds\" : 0.001,
\"status\" : \"SUCCESS\"
'}'אובייקטי תגובה נפוצים
רבות משיטות ה- API מחזירות אובייקטי נתונים בעלי מבנה זהה. אובייקטי נתונים נפוצים ומשותפים אלה מתוארים בפירוט להלן.
RegistrarPricing
מתאר את התמחור הקמעונאי של רשם עבור הרחבה עבור סוג מחיר מסוים (register, renewal, transfer), כולל פרטים נוספים כגון תנאים מיוחדים, עמלות, מס ומבצעים.
| נתיב | סוג | תיאור |
|---|---|---|
id | string | מחרוזת מזהה רשם המזהה באופן ייחודי את הרשם. |
name | string | שם התצוגה של הרשם. |
price | string | המחיר הקמעונאי של הרשם עבור ההרחבה כמחרוזת מספרית. |
priceOriginal | string |
המחיר הקמעונאי הרגיל של הרשם עבור הסיומת כמחרוזת מספרית. שדה זה יהיה קיים רק אם price הוא מחיר מבצע.הערה: שדה זה קיים רק כאשר האובייקט RegistrarPricing מקונן בהקשר של pricetype (לדוגמה, בתגובה מ - getCheapestRegistrars). |
pricetype | string |
סוג תמחור ההרחבה, אחד מתוך: register, renewal, transfer.
|
prices | object | התמחור הקמעונאי של הרשם להרחבה לכל סוגי המחירים. |
prices[pricetype] | string |
המחיר הקמעונאי הסופי של הרשם עבור ההרחבה ו- [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer, restore, whoisprivacy. דוגמה:__לדוגמה__ |
pricesOriginal | object |
התמחור הקמעונאי הרגיל של הרשם להרחבה לכל סוגי המחירים. שדה זה לא יהיה קיים אם לרשם אין פעיל promos.
|
pricesOriginal[pricetype] | string |
המחיר הקמעונאי הרגיל של הרשם עבור ההרחבה ו- [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer, restore, whoisprivacy.
|
promo | object |
אובייקט המייצג תמחור קידום מכירות שהוחל על מחיר הרשם עבור הרחבה זו. אם לא הוחל קידום מכירות, שדה זה לא יהיה קיים. אובייקט פרומו לדוגמה: __לדוגמה__ |
promos | array of objects | מערך אובייקטי רשםפרומו המייצגים את כל מחירי המבצע הפעילים המוצעים על ידי הרשם עבור הרחבה זו. |
terms | object |
אוסף של אובייקטים המייצגים תנאים מיוחדים החלים על תמחור הרשם. אם לא חלים תנאים מיוחדים, שדה זה לא יהיה קיים. כל אובייקט משנה מפתח עם מזהה מונח: limitPerCustomer - מציין כי התמחור תקף רק עבור מספר מסוים של דומיינים לכל לקוח.newCustomerOnly - מציין כי התמחור תקף רק עבור לקוחות חדשים.affiliateLink - מציין כי התמחור תקף רק כאשר הלקוח ניגש לאתר הרשם באמצעות קישור שותפים. nameserverLockIn - מציין כי דומיינים שנרכשו יכולים להשתמש רק בשרתי השמות של הרשם.idSubmissionRequired - מציין שהלקוח חייב לשלוח את מזהה התמונה או את רישום העסק שלו כדי להשלים רכישה.אובייקטים של מונחים לדוגמה: __לדוגמה__ |
terms[term].count | number |
הכמות שהמונח מגביל את הלקוח אליה. לדוגמה, אם count = 1, אז הלקוח מוגבל לדומיין אחד במחיר שצוין. שדה זה לא יהיה קיים אם הוא אינו חל.
|
terms[term].pricetype | array of strings |
סוגי המחירים שהמונח חל עליהם: register, renewal, transfer. שדה זה יהיה קיים רק אם סוג המחיר של אובייקט RegistrarPricing לא צוין.
|
notes | object |
אוסף של אובייקטים המייצגים פתקים הנוגעים לתמחור הרשם. אם אין הערות תמחור, ערך זה יהיה אובייקט ריק. כל אובייקט משנה מסומן במפתח עם מזהה הערה: currencyExchangeRate, feeIcann, feeTax, feePayment
|
notes.feeIcann | object |
מציין אם עמלת ICANN נוספה למחיר הסופי עבור TLD (בדרך כלל $0.18 USD). אם הערה זו קיימת, פירוש הדבר שהרשם אינו כולל את עמלת ICANN במחיר המפורסם שלהם, ובמקום זאת מוסיף אותה כתשלום נוסף למחיר TLD's בקופה ללקוח. אובייקט הערה לדוגמה fee_icann : '{'השדה pricetype מציין אילו סוגי מחירים כפופים לעמלה, והשדה addedToListPrice מציין שהעמלה נוספה למחיר הסופי.
|
notes.feeTax | array of objects |
מפרט את שיעורי המס השונים הנגבים על ידי רשם, את הלקוחות שעליהם חל המס ואם המס המחושב נכלל במחיר הסופי של ה- TLD. אנא שימו לב כי מסים כלולים במחיר הסופי של ה-TLD רק אם הרשם אינו כולל את המס במחירים המפורסמים שלו והמס מחויב לכל הלקוחות. מערך אובייקטים לדוגמה feeTax : '{'
|
notes.feeTax[].type | string | תווית המתארת את סוג המס, כלומר 'vat' מס ערך מוסף, 'gst' מס סחורות ושירותים וכו'. |
notes.feeTax[].amountRate | number|string | סכום שיעור המס. פעולה זו תהיה שיעור אחוז המס כמספר, או המחרוזת '~' המציינת ששיעור המס משתנה בהתאם לקריטריונים של הלקוח, כגון מיקום. |
notes.feeTax[].amountRateType | string | ערך 'percent' המחרוזת מציין שהערך amountRate הוא אחוז מספרי. ערך 'percent-varies-by-location' המחרוזת מציין ששיעור המס משתנה בהתאם לאזור החיוב או למדינה של הלקוח. |
notes.feeTax[].appliesToCustomers | string|array of strings | המחרוזת '*' מציינת שהמס חל על כל הלקוחות. אחרת, ערך זה יהיה מערך של מחרוזות קוד מדינה ISO 3166-1 alpha-2 המגדירות אילו מדינות כפופות למס. חריג אחד שראוי לציין: המערך עשוי להכיל את מחרוזת 'eu'הקוד שאינה מדינה , המייצגת את כל המדינות באיחוד האירופי. |
notes.feeTax[].addedToListPrice | boolean | מציין אם סכום המס המחושב נוסף למחיר הסופי. |
notes.feePayment | object | מציין אם הרשם גובה תשלום נוסף בהתבסס על שיטת התשלום של הלקוח, ואם העמלה נכללה במחיר הסופי עבור ה- TLD. אובייקט לדוגמה feePayment : '{' |
notes.feePayment.amountRate | string | סכום העמלה. זה יהיה שיעור אחוז העמלה כמספר, או המחרוזת '~' המציינת ששיעור העמלה משתנה בהתאם לקריטריונים של הלקוח, כגון אמצעי תשלום. |
notes.feePayment.amountRateMin | string | סכום העמלה המינימלי, חל רק אם העמלה משתנה. |
notes.feePayment.amountRateMax | string | סכום העמלה המרבי, חל רק אם העמלה משתנה. |
notes.feePayment.amountRateType | string | ערך 'percent' המחרוזת מציין שהערך amountRate הוא אחוז מספרי. ערך 'percent-varies-by-method' המחרוזת מציין שהעמלה היא אחוז המשתנה בהתאם לשיטת התשלום של הלקוח. |
notes.feePayment.addedToListPrice | boolean | מציין אם סכום העמלה המחושב נוסף למחיר הסופי. |
notes.currencyExchangeRate | object | מציין שמחירי הרשם נרשמו במטבע לאומי אחר, והומרו ל- USD. פרטי המרת המטבע מיוצגים כ:baseמטבע התמחור של הרשם כקוד בן 3 אותיות (כלומר אירו).:quoteהמטבע שאליו הומרו המחירים (תמיד יהיה USD)::rateשער החליפין המשמש לביצוע המרת המטבע.: אובייקט הערה לדוגמה currencyExchangeRate : '{' |
threeYearValueScore | number | מדידה מספרית של ערך, הנקבעת על ידי תמחור ותכונות חינמיות, עבור בעלות על דומיין עם סיומת זו באמצעות הרשם לתקופה של 3 שנים. ככל שהמספר גדול יותר, כך מוצע ערך רב יותר. |
currency | string |
קוד מטבע ISO 4217 בן שלוש אותיות של נתוני התמחור. ערך זה הוא כרגע רק USD.
|
freeFeatures | array of objects |
מערך של אובייקטים המייצגים את התכונות החינמיות שהרשם מציע עם בעלות על דומיין. האובייקט כולל את הכמות ומשך הזמן של כל תכונה. לכל אובייקט מקודד מזהה תכונה חינמי:dns - שירות DNS חינם.whois-privacy - שירות הפרטיות WHOIS.email-account - חשבונות דוא"ל ללא תשלום.email-forward - העברת דוא"ל ללא תשלום.ssl-cert - תעודות SSL בסיסיות ללא תשלום.מערך תכונות חינמי לדוגמה: __לדוגמה__ |
freeFeatures[].count | number | כמות התכונה שהרשם מציע בחינם. שדה זה לא יהיה קיים אם הוא אינו חל. |
freeFeatures[].duration | number |
מספר הימים שהתכונה מוצעת בחינם על-ידי הרשם. אם , duration = 365אז התכונה מוצעת בחינם למשך שנה אחת. שדה זה לא יהיה קיים אם הוא אינו חל.
|
RegistrarPromo
מתאר קידום פעיל המוצע על-ידי רשם. דוגמה:
__לדוגמה__
| נתיב | סוג | תיאור |
|---|---|---|
promo.code | string | קוד המבצע שעל הלקוח להזין בקופה כדי לקבל את המבצע המוזל. |
promo.amount | string |
הסכום המספרי של תמחור המבצע. בהתאם לסוג המבצע, זה יכול להיות המחיר המוזל (), הסכום שהופחת מהמחיר הרגיל (), או הסכום באחוזים שהופחת מהמחיר הרגיל (pricediscountdiscount-percent).
|
promo.type | string |
מחרוזת המייצגת את סוג תמחור המבצע. יהיה אחד מהערכים הבאים: price - כלומר שדה הסכום של המבצע הוא המחיר המוזל החדשdiscount - פירושו ששדה סכום המבצע הופחת מהמחיר הרגיל כדי לקבל את המחיר המיושםdiscount-percent - פירושו שדה הסכום של המבצע הוא אחוזים, והאחוז הופחת מהמחיר הרגיל כדי לקבל את המחיר החל.
|
promo.start | string |
ISO 8601 datetime (אזור זמן UTC) של מתי המבצע התחיל. לא יהיה נוכח אם לא היה תאריך התחלה ספציפי. דוגמה: 2015-06-22T00:00:00
|
promo.end | string |
ISO 8601 datetime (אזור זמן UTC) של מתי המבצע יסתיים. לא יהיה נוכח אם אין תאריך סיום ספציפי. דוגמה: 2025-06-22T00:00:00
|
promo.pricetype | array of strings |
סוגי המחירים שעליהם חל המבצע: register, renewal, transfer. הערה: שדה זה קיים רק כאשר הוא מקונן בהקשר של סוג מחיר (לדוגמה, בתגובה מ - getCheapestRegistrars). |
קודי שגיאה
בעת כשל בבקשה, אובייקט התגובה JSON יכול להכיל אובייקט שגיאה אחד או יותר המתארים מה השתבש. להלן רשימה לא מקיפה של קודי שגיאה מזהים שניתן להגדיר בשדה של code אובייקט השגיאה.
| קוד | תיאור |
|---|---|
| 502 | שרת API אינו זמין באופן זמני. |
| RATE_LIMITED | מספר בקשות ה- API של הלקוח חרג מהמותר לכל היותר. |
| INVALID_METHOD | שיטת ה- API המבוקשת אינה קיימת. |
| SYSTEM | אירעה שגיאת מערכת לא ידועה. |
| RESPONSE_TIMEOUT | הזמן הקצוב לשרת API הסתיים בעת יצירת תגובה. |
| PARAMETER_REQUIRED | פרמטר נדרש עבור השיטה שנקראה לא סופק על ידי הלקוח. |
| ACCOUNT_INACTIVE | חשבון הלקוח אינו פעיל עוד ונדרש חידוש מנוי עבור גישת API. |
| NO_ACCESS | רמת החשבון של הלקוח אינה מעניקה גישת API. נדרש שדרוג חשבון עבור גישת API. |
| AUTH_INVALID | האימות נכשל: מפתחות ה- API שסופקו אינם פעילים או אינם חוקיים. |
| CLIENT_IPS_EXCEEDED | בוצעה חריגה מכתובות ה- IP הייחודיות המרביות של לקוחות המורשים לגשת ל- API עבור זוג מקשי ה- API שסופק. |
| REQUEST_ENDED_BY_CLIENT | הבקשה הופסקה על ידי הלקוח לפני שניתן היה לייצר תגובה. |
מגבלות
השימוש ב- API כפוף למגבלות מסוימות כדי למנוע שימוש לרעה. מגבלות שימוש אלה מוצגות להלן וכפופות לשינוי ללא הודעה מוקדמת.
| סוג | תיאור |
|---|---|
| מפתחות API לכל חשבון | 3 |
| מגבלת תעריף | 100 מקסימום בקשות לכל 15 דקות |
| כתובות IP של לקוח לכל מפתח API | 5 כתובות IP ייחודיות של לקוח לכל מקש לכל 1440 דקות |
שיטות הרחבה
get
מחזירה הרחבות ואת נתוני התמחור והפרטים המשויכים אליהן. שיטה זו דומה לאחזור הנתונים המוצגים בדף פרטי TLD אחד או יותר (לדוגמה, .com), למעט נתוני "היסטוריית המחירים הזולים ביותר", שאינם מוחזרים בשיטה זו (עיין בשיטת getAggregateHistory לנתונים היסטוריים).
נקודת קצה של API:https://api.tld-list.com/v1/extension/get
זמן תגובה:~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions
פרמטרים של בקשה
| מפתח | סוג | חובה | תיאור |
|---|---|---|---|
extensions | array of strings |
מציין אילו הרחבות לאחזר. אל תכלול נקודה קודמת. שמות סיומות יכולים להיות unicode או המקבילה punycode שלהם. אם הושמט, כל ההרחבות המפורטות ב- TLD-List יוחזרו.
דוגמה: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
| |
includeFields | array of strings |
ציין נתונים מסוימים לחזרה לפי שם מפתח. מפתחות שלא נשלחו בפרמטר זה יושמטו. כברירת מחדל, כל השדות הזמינים מוחזרים. עיין בטבלת התגובות לקבלת רשימה של שדות זמינים. שדות מקוננים אינם נתמכים.
דוגמה: "includeFields": ["name", "registrars", "dnssecSupported"]
| |
excludeFields | array of strings |
ציין נתוני cetain שלא ייכללו לפי שם מפתח. מפתחות שנמסרו בפרמטר זה יושמטו. כברירת מחדל, שדות אינם נכללים. עיין בטבלת התגובות לקבלת רשימה של שדות זמינים. שדות מקוננים אינם נתמכים.
דוגמה: "excludeFields": ["available", "syntax", "sponsor"]
| |
includeRegistrars | array of strings |
מזהי המחרוזות של רשמים פעילים שיש לכלול בתוצאות. השתמש בשיטה getIds כדי לקבל רשימה של מזהים של כל הרשמים הרשומים באופן פעיל ב- TLD-List.
דוגמה: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]
| |
excludeRegistrars | array of strings |
מזהי המחרוזות של רשמים פעילים שיש לא לכלול בתוצאות. השתמש בשיטה getIds כדי לקבל רשימה של מזהים של כל הרשמים הרשומים באופן פעיל ב- TLD-List.
דוגמה: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]
| |
omitExtensionsWithoutRegistrars | boolean |
כאשר true, הרחבות שאין להן נתוני תמחור רשם בתוצאות מושמטות. כברירת מחדל, כל ההרחבות כלולות.
דוגמה: "omitExtensionsWithoutRegistrars": true
|
אובייקט תגובה
| נתיב | סוג | תיאור |
|---|---|---|
data | array of objects | מערך שמות סיומות. |
data[].available | object | מושא תאריכי הזמינות של שלב הסיומת. |
data[].available.general | object | ISO 8601 datetime (אזור זמן UTC) של מתי רישום דומיין זמין לציבור הרחב. |
data[].available.sunrise | object |
טווחי אובייקט start ותאריך end המייצגים את שלב TLD's Sunrise (כאשר בעלי סימן מסחרי יכולים להתחיל להגיש בקשה לרישום דומיינים רלוונטיים). דוגמה: __לדוגמה__ |
data[].available.trademark | object |
טווח האובייקטים וזמני end התאריכים המייצג את שלב הסימן המסחרי TLD's (תקופה שבה בעלי סימן מסחרי יקבלו הודעה ממסלקת סימני המסחר אם רשום דומיין התואם start את הסימן שלהם). דוגמה:__לדוגמה__ |
data[].available.other | array of objects |
מערך של אובייקטים המייצגים שלבי שיגור שונים של הסיומת ואת טווחי הזמן שלהם, כגון "Land Rush" ו- "Qualified Launch Program". דוגמה: __לדוגמה__ |
data[].average | object | אובייקט המכיל את המחיר הממוצע של ההרחבה, לפי סוג מחיר, עבור הרשמים הכלולים. |
data[].average[pricetype] | string |
המחיר הממוצע של הסיומת כמחרוזת מספרית עבור [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer, restore, whoisprivacy.
|
data[].category | string |
הקטגוריות שהסיומת סווגה תחתן. כל אובייקט במערך מייצג קטגוריה ומכיל את השדות הבאים:id - מזהה קטגוריה של מספר שלם המשמש באופן פנימי על ידי TLD-List.idstr - מזהה קטגוריית מחרוזת חלופית.name - שם קטגוריה באנגלית.desc - תיאור קטגוריה באנגלית.מערך קטגוריות לדוגמה: __לדוגמה__ |
data[].dnssecSupported | boolean | אם אזור ה- DNS של הרישום תומך ב- DNS Security Extensions (DNSSEC). |
data[].hasPremiumDomains | object |
אובייקט של מפתחות [pricetype] וערכים בוליאניים, המייצגים אם הרישום גובה מחירים גבוהים יותר עבור שמות מתחם נבחרים מסוג "Premium". דוגמה: __לדוגמה__ |
data[].infoUpdated | string |
ISO 8601 datetime (אזור זמן UTC) של מתי המידע הבסיסי TLD's (הגבלות, תאריכי זמינות וכו ') נבדק ועודכן לאחרונה. הערה: תאריך חדש updated.info אינו מעיד בהכרח על כך שהתרחש שינוי כלשהו בנתונים. הוא מציין רק מתי הנתונים נבדקו והוגדרו לאחרונה.
|
data[].intendedUsage | string | מידע כללי על אופן השימוש בהרחבה על ידי הנרשמים. |
data[].language | string | קוד השפה ISO 639-1 2 תווים. אם השפה מבוססת אנגלית או לא ידועה, שדה זה לא יהיה קיים. |
data[].level | integer | מספר שלם המייצג את רמת התחום של הסיומת. 1 = תחום ברמה העליונה, 2 = תחום ברמה שנייה, 3 = תחום ברמה שלישית וכו'. |
data[].localPresenceRequired | boolean | אם הרישום דורש מהנרשם כתובת פיזית מקומית לאזור. |
data[].median | object | אובייקט המכיל את המחיר החציוני של ההרחבה, לפי סוג מחיר, עבור הרשמים הכלולים. |
data[].median[pricetype] | string |
המחיר החציוני של הסיומת כמחרוזת מספרית עבור [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer, restore, whoisprivacy.
|
data[].name | string | שם Unicode של סיומת התחום. |
data[].nameservers | array |
שרתי שמות הבסיס של הרישום המאחסנים את שרתי השמות המוסמכים של הדומיינים הרשומים. מערך שרתי שמות לדוגמה: __לדוגמה__ |
data[].parentTld | string | דומיין האב ברמה העליונה של התוסף. אם זהו TLD, שדה זה לא יהיה קיים. |
data[].pricingUpdated | string |
ISO 8601 datetime (אזור זמן UTC) של המועד שבו תמחור רשם TLD's נבדק ועודכן לאחרונה. הערה: תאריך חדש updated.pricing אינו מעיד בהכרח על כך שהתרחש שינוי כלשהו בנתונים. הוא מציין רק מתי הנתונים נבדקו והוגדרו לאחרונה.
|
data[].punycode | string | שם Punycode של סיומת התחום. קיים רק עבור הרחבות IDN. |
data[].registerMaxYears | integer | מקסימום שנים שניתן לרשום דומיין בעת רכישתו. |
data[].registerMinYears | integer | מינימום שנים בהן ניתן לרשום דומיין בעת הרכישה. |
data[].registrarsIncluded | integer |
ספירת הרשמים הכלולים במערך שהוחזר registrars .
|
data[].registrarsTotal | integer | סה"כ רשמים פעילים שמוכרים את ההרחבה. |
data[].registrars | array of objects | מערך אובייקט(י) RegistrarPricing המכיל נתוני תמחור ותכונות של רשם. |
data[].registryUrl | string | האתר הרשמי של הרישום למידע על רישום TLD. |
data[].renewalMinYears | integer | מינימום השנים המותרות שניתן לחדש דומיין. |
data[].restrictions | string | תיאור קצר של הגבלות ודרישות הרישום TLD's. אם אין הגבלות, שדה זה לא יהיה קיים |
data[].sponsor | object | אובייקט המכיל נתונים על הארגון נותן החסות של ההרחבה או הארגון הניהולי. |
data[].sponsor.name | string | שם הארגון נותן החסות המאושר על ידי ICANN או ארגון הניהול ccTLD. |
data[].sponsor.address | string |
מיקום פיזי של הארגון נותן החסות או ארגון הניהול ccTLD. מערך כתובות לדוגמה: __לדוגמה__ |
data[].sponsorParentCompany | string | שם הגוף בעל השליטה בארגון נותן החסות. |
data[].romanized | string | הסיומת תועתקה לתווים לטיניים. אם השפה מבוססת אנגלית, או לא ידועה, שדה זה לא יהיה קיים. |
data[].rtl | string | אם הסיומת נקראת "מימין לשמאל" (כלומר. Arabric TLDs), ערך זה יהיה __true__. אם הוא נקרא מ "משמאל לימין", ערך זה יהיה __false__. אם לא ידוע, ערך זה לא יהיה קיים. |
data[].syntax | object | אובייקט המכיל פרטים על הכללים וההגבלות המותרים של שם המתחם של הסיומת. |
data[].syntax.minChars | integer | מספר מינימלי של תווים בתווית מותר להירשם. |
data[].syntax.maxChars | integer | מספר התווים המרבי בתווית מותר לרישום. |
data[].targetMarket | string | האנשים או הישויות שהסיומת נועדה לשרת. |
data[].translation | string | התרגום לאנגלית של הסיומת. אם הסיומת כבר מבוססת אנגלית, או שהתרגום אינו ידוע, ערך זה לא יהיה קיים. |
data[].type | string |
סוג הסיומת המזוהה על-ידי אחת מהמחרוזות הבאות:gTLD: תחום כללי ברמה העליונה.ccTLD: דומיין ברמה העליונה של קידומת מדינה.grTLD: תחום ברמה העליונה עם הגבלה גנרית.sTLD: דומיין ממומן ברמה העליונה.
|
data[].wholesale | object | אובייקט המכיל את המחירים הסיטונאיים של ההרחבה לפי סוג מחיר. מחירים סיטונאיים הם המחירים שגובה המרשם מרשם עבור רכישת שמות מתחם. |
data[].whoisPrivacySupported | boolean | אם ההרחבה מאפשרת לשירותי הפרטיות של WHOIS להסוות את שמות הנרשמים ואת פרטי הקשר שלהם. אם לא ידוע, שדה זה לא יהיה נוכח. |
data[].whoisServer | boolean | שם מארח של שרת הרישום המאחסן פרטי קשר של נרשם תחום. |
בקשה/תגובה לדוגמה
curl -X POST https://api.tld-list.com/v1/extension/get -H 'Content-Type: application/json' -d ''{'\"extensions\": [\"com\"], \"includeRegistrars\": [\"porkbun\",\"godaddy\",\"epik\"], \"apiKeyPublic\":\"MY_PUBLIC_KEY\",\"apiKeyPrivate\":\"MY_PRIVATE_KEY\"'}''
'{'
\"data\" : [
'{'
\"average\" : '{'
\"register\" : \"7.63\",
\"renewal\" : \"13.63\",
\"transfer\" : \"9.63\"
'}',
\"clicks\" : 226,
\"dnssecSupported\" : true,
\"hasPremiumDomains\" : '{'
\"register\" : false,
\"renewal\" : false
'}',
\"infoUpdated\" : \"2023-02-04T11:05:09\",
\"level\" : 1,
\"localPresenceRequired\" : false,
\"median\" : '{'
\"register\" : \"3.17\",
\"renewal\" : \"20.17\",
\"transfer\" : \"8.17\"
'}',
\"name\" : \"com\",
\"nameservers\" : [
'{'
\"host\" : \"a.gtld-servers.net\",
\"ipv4\" : \"192.5.6.30\",
\"ipv6\" : \"2001:503:a83e:0:0:0:2:30\"
'}',
'{'
\"host\" : \"b.gtld-servers.net\",
\"ipv4\" : \"192.33.14.30\",
\"ipv6\" : \"2001:503:231d:0:0:0:2:30\"
'}',
'{'
\"host\" : \"c.gtld-servers.net\",
\"ipv4\" : \"192.26.92.30\",
\"ipv6\" : \"2001:503:83eb:0:0:0:0:30\"
'}',
'{'
\"host\" : \"d.gtld-servers.net\",
\"ipv4\" : \"192.31.80.30\",
\"ipv6\" : \"2001:500:856e:0:0:0:0:30\"
'}',
'{'
\"host\" : \"e.gtld-servers.net\",
\"ipv4\" : \"192.12.94.30\",
\"ipv6\" : \"2001:502:1ca1:0:0:0:0:30\"
'}',
'{'
\"host\" : \"f.gtld-servers.net\",
\"ipv4\" : \"192.35.51.30\",
\"ipv6\" : \"2001:503:d414:0:0:0:0:30\"
'}',
'{'
\"host\" : \"g.gtld-servers.net\",
\"ipv4\" : \"192.42.93.30\",
\"ipv6\" : \"2001:503:eea3:0:0:0:0:30\"
'}',
'{'
\"host\" : \"h.gtld-servers.net\",
\"ipv4\" : \"192.54.112.30\",
\"ipv6\" : \"2001:502:8cc:0:0:0:0:30\"
'}',
'{'
\"host\" : \"i.gtld-servers.net\",
\"ipv4\" : \"192.43.172.30\",
\"ipv6\" : \"2001:503:39c1:0:0:0:0:30\"
'}',
'{'
\"host\" : \"j.gtld-servers.net\",
\"ipv4\" : \"192.48.79.30\",
\"ipv6\" : \"2001:502:7094:0:0:0:0:30\"
'}',
'{'
\"host\" : \"k.gtld-servers.net\",
\"ipv4\" : \"192.52.178.30\",
\"ipv6\" : \"2001:503:d2d:0:0:0:0:30\"
'}',
'{'
\"host\" : \"l.gtld-servers.net\",
\"ipv4\" : \"192.41.162.30\",
\"ipv6\" : \"2001:500:d937:0:0:0:0:30\"
'}',
'{'
\"host\" : \"m.gtld-servers.net\",
\"ipv4\" : \"192.55.83.30\",
\"ipv6\" : \"2001:501:b1f9:0:0:0:0:30\"
'}'
],
\"pricingUpdated\" : \"2023-02-04T11:04:33\",
\"registerMaxYears\" : 10,
\"registerMinYears\" : 1,
\"registrars\" : [
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"dns\"
'}',
'{'
\"name\" : \"whois-privacy\"
'}'
],
\"id\" : \"godaddy\",
\"name\" : \"GoDaddy\",
\"notes\" : '{'
\"feeIcann\" : '{'
\"addedToListPrice\" : true,
\"amount\" : \"0.18\",
\"pricetype\" : [
\"register\",
\"renewal\",
\"transfer\"
]
'}',
\"feeTax\" : [
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"~\",
\"amountRateType\" : \"percent-varies-by-location\",
\"appliesToCustomers\" : [
\"eu\"
],
\"type\" : \"vat\"
'}',
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"15\",
\"amountRateType\" : \"percent\",
\"appliesToCustomers\" : [
\"in\"
],
\"type\" : \"gst\"
'}',
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"10\",
\"amountRateType\" : \"percent\",
\"appliesToCustomers\" : [
\"au\"
],
\"type\" : \"gst\"
'}'
]
'}',
\"prices\" : '{'
\"register\" : \"3.17\",
\"renewal\" : \"20.17\",
\"transfer\" : \"8.17\",
\"whoisPrivacy\" : \"0.00\"
'}',
\"pricesOriginal\" : '{'
\"register\" : \"10.18\"
'}',
\"promos\" : [
'{'
\"amount\" : \"2.99\",
\"code\" : \"GDD2dom\",
\"pricetype\" : [
\"register\"
],
\"start\" : \"2023-01-01T00:00:00\",
\"type\" : \"price\"
'}'
],
\"terms\" : '{'
\"limitPerCustomer\" : '{'
\"count\" : 1,
\"pricetype\" : [
\"register\"
]
'}'
'}',
\"threeYearValueScore\" : \"5.76\"
'}',
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"whois-privacy\"
'}',
'{'
\"name\" : \"dns\"
'}'
],
\"id\" : \"epik\",
\"name\" : \"Epik\",
\"prices\" : '{'
\"register\" : \"9.99\",
\"renewal\" : \"10.99\",
\"restore\" : \"90.00\",
\"transfer\" : \"9.99\",
\"whoisPrivacy\" : \"0.00\"
'}',
\"threeYearValueScore\" : \"8.29\"
'}',
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"whois-privacy\"
'}',
'{'
\"name\" : \"dns\"
'}',
'{'
\"name\" : \"email-forward\"
'}',
'{'
\"name\" : \"ssl-cert\"
'}'
],
\"id\" : \"porkbun\",
\"name\" : \"Porkbun\",
\"prices\" : '{'
\"register\" : \"8.73\",
\"renewal\" : \"9.73\",
\"transfer\" : \"9.73\",
\"whoisPrivacy\" : \"0.00\"
'}',
\"pricesOriginal\" : '{'
\"register\" : \"9.73\"
'}',
\"promos\" : [
'{'
\"amount\" : \"1.00\",
\"code\" : \"AWESOMENESS\",
\"pricetype\" : [
\"register\"
],
\"type\" : \"discount\"
'}'
],
\"terms\" : '{'
\"limitPerCustomer\" : '{'
\"count\" : 1,
\"pricetype\" : [
\"register\"
]
'}'
'}',
\"threeYearValueScore\" : \"16.03\"
'}'
],
\"registryUrl\" : \"http://www.verisigninc.com\",
\"renewalMinYears\" : 1,
\"rtl\" : false,
\"sponsor\" : '{'
\"address\" : [
\"12061 Bluemont Way\",
\"Reston Virginia 20190\",
\"United States\"
],
\"name\" : \"VeriSign Global Registry Services\"
'}',
\"syntax\" : '{'
\"maxChars\" : 63,
\"minChars\" : 2
'}',
\"type\" : \"gTLD\",
\"whoisPrivacySupported\" : true,
\"whoisServer\" : \"whois.verisign-grs.com\",
\"wholesale\" : '{'
\"register\" : \"8.97\",
\"renewal\" : \"8.97\",
\"transfer\" : \"8.97\"
'}'
'}'
],
\"errors\" : [],
\"seconds\" : 0.068,
\"status\" : \"SUCCESS\"
'}'
getNames
החזרת כל שמות הסיומים.
נקודת קצה של API:https://api.tld-list.com/v1/extension/getNames
זמן תגובה:~1 second
פרמטרים של בקשה
| מפתח | סוג | חובה | תיאור |
|---|---|---|---|
omitExtensionsWithoutRegistrars | boolean |
כאשר true, הרחבות שאין להן נתוני תמחור רשם בתוצאות מושמטות. ברירת המחדל היא false.
| |
wantPunycode | boolean |
קידוד כל סיומות IDN שהוחזרו כ- punycode במקום unicode. ברירת המחדל היא false.
|
אובייקט תגובה
| נתיב | סוג | תיאור |
|---|---|---|
data | array of strings | מערך שמות סיומות. |
בקשה/תגובה לדוגמה
curl -X POST https://api.tld-list.com/v1/extension/getNames -H 'Content-Type: application/json' -d ''{'\"apiKeyPublic\":\"MY_PUBLIC_KEY\",\"apiKeyPrivate\":\"MY_PRIVATE_KEY\", \"wantPunycode\": true, \"omitExtensionsWithoutRegistrars\": true'}''
'{'
\"data\" : [
\"2000.hu\",
\"5g.in\",
\"6g.in\",
\"aaa.pro\",
\"abc.br\",
\"abkhazia.su\",
\"abo.pa\",
\"abogado\",
\"abr.it\",
\"abruzzo.it\",
\"abudhabi\",
...
\"xn--3bst00m\",
\"xn--jvr189m\",
\"xn--imr513n\",
\"xn--j6w193g\",
\"xn--t60b56a\",
\"xn--mk1bu44c\",
\"xn--3e0b707e\"
],
\"errors\" : [],
\"seconds\" : 0.697,
\"status\" : \"SUCCESS\"
'}'
getCheapestRegistrar
הפונקציה מחזירה את הרשמים/הספקים הזולים ביותר, את התמחור שלהם, את המחיר החציוני ואת המחיר הממוצע לסיומת דומיין. הרחבות שאינן נמכרות על ידי רשמים כלשהם אינן מוחזרים.
נקודת קצה של API:https://api.tld-list.com/v1/extension/getCheapestRegistrar
זמן תגובה:~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions
פרמטרים של בקשה
| מפתח | סוג | חובה | תיאור |
|---|---|---|---|
pricetypes | array of strings |
מציין את סוגי התמחור שיש לאחזר. אם הושמט, כל 3 סוגי המחירים (register, renewal, transfer) יוחזרו.
דוגמה: "pricetypes": ["register", "transfer"]
| |
extensions | array of strings |
מציין אילו הרחבות יש לאחזר. אל תכלול נקודה קודמת. שמות הרחבות יכולים להיות unicode או המקבילה שלהם punycode. אם הושמט, כל ההרחבות המפורטות ב- TLD-List יוחזרו.
דוגמה: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
| |
includeRegistrars | array of strings |
מזהי המחרוזת של רשמים פעילים שיש לכלול בעת קביעת התמחור הזול ביותר והחישובים המצטברים. המערכת תתעלם מרשמים שלא צוינו בפרמטר זה. השתמש בשיטה getIds כדי לקבל רשימה של כל הרשמים הרשומים באופן פעיל ב- TLD-List.אם פרמטר זה הושמט, כל הרשמים המפורטים באופן פעיל ב- TLD-List ייחשבו.
דוגמה: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]
| |
excludeRegistrars | array of strings |
מזהי המחרוזת של רשמים פעילים כדי לא לכלול בעת קביעת התמחור הזול ביותר וחישובים מצטברים. כל הרשמים שלא צוינו בפרמטר זה ייחשבו. השתמש בשיטה getIds כדי לקבל רשימה של כל הרשמים הרשומים באופן פעיל ב- TLD-List.אם פרמטר זה מושמט, לא יתעלמו מרשמים.
דוגמה: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]
| |
omitExtensionsWithoutRegistrars | boolean |
כאשר true, הרחבות שאין להן נתוני תמחור של הרשם בתוצאות מושמטות. מצב זה מתרחש כאשר הפרמטרים שהועברו ו/או includeRegistrars גרמו להרחבה שבדרך excludeRegistrars כלל כוללת נתוני תמחור של הרשם להיות ללא נתוני תמחור תואמים של הרשם. הרחבות אלה כלולות כברירת מחדל, אך עם מערכים ריקים עבור נתוני התמחור שלהן. הגדר כדי true להשמיט הרחבות אלה מהתוצאות.
דוגמה: "omitExtensionsWithoutRegistrars": true
|
אובייקט תגובה
| נתיב | סוג | תיאור |
|---|---|---|
data | array of objects | מערך של אובייקטים, שכל אחד מהם מייצג סיומת תחום. |
data[].name | string | שם Unicode של סיומת התחום. |
data[].punycode | string | שם Punycode של סיומת התחום. קיים רק עבור הרחבות IDN. |
data[].currency | string |
קוד המטבע ISO 4217 בן שלוש האותיות של נתוני התמחור. ערך זה הוא כרגע רק USD.
|
data[].registrarsIncluded | number | ספירת הרשמים הכלולים בנתוני התמחור המוחזרים. |
data[].average | object | אובייקט המכיל את המחיר הממוצע של ההרחבה, לפי סוג מחיר, עבור הרשמים הכלולים. |
data[].average[pricetype] | string |
המחיר הממוצע של ההרחבה כמחרוזת מספרית עבור [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer.
|
data[].median | object | אובייקט המכיל את המחיר החציוני של ההרחבה, לפי סוג מחיר, עבור הרשמים הכלולים. |
data[].median[pricetype] | string |
המחיר החציוני של ההרחבה כמחרוזת מספרית עבור [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer.
|
data[].cheapest | object | אובייקט המכיל את הרשמים הזולים ביותר עבור ההרחבה לפי סוג מחיר. |
data[].cheapest[pricetype] | array of objects |
מערך של אובייקטי RegistrarPricing המכילים את הרשמים הזולים ביותר לפי [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer.נתונים אלה הם מערך מכיוון שהמחיר הזול ביותר עבור ההרחבה יכול להיות אותו מחיר שמציע יותר מרשם אחד.
|
בקשה/תגובה לדוגמה
curl -X POST https://api.tld-list.com/v1/extension/getCheapestRegistrar -H 'Content-Type: application/json' -d ''{'\"apiKeyPublic\":\"MY_PUBLIC_KEY\",\"apiKeyPrivate\":\"MY_PRIVATE_KEY\", \"includeRegistrars\": [\"godaddy\", \"namecheap\", \"porkbun\", \"namesilo\", \"netim\"], \"extensions\": [\"com\", \"co.uk\"]'}''
'{'
\"data\" : [
'{'
\"average\" : '{'
\"register\" : \"7.85\",
\"renewal\" : \"10.25\",
\"transfer\" : \"11.99\"
'}',
\"cheapest\" : '{'
\"register\" : [
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"dns\"
'}',
'{'
\"name\" : \"email-forward\"
'}',
'{'
\"name\" : \"ssl-cert\"
'}'
],
\"id\" : \"porkbun\",
\"name\" : \"Porkbun\",
\"price\" : \"4.96\",
\"priceOriginal\" : \"5.96\",
\"prices\" : '{'
\"register\" : \"4.96\",
\"renewal\" : \"5.96\"
'}',
\"pricesOriginal\" : '{'
\"register\" : \"5.96\"
'}',
\"pricetype\" : \"register\",
\"promo\" : '{'
\"amount\" : \"1.00\",
\"code\" : \"AWESOMENESS\",
\"type\" : \"discount\"
'}',
\"promos\" : [
'{'
\"amount\" : \"1.00\",
\"code\" : \"AWESOMENESS\",
\"type\" : \"discount\"
'}'
],
\"terms\" : '{'
\"limitPerCustomer\" : '{'
\"count\" : 1
'}'
'}',
\"threeYearValueScore\" : \"18.36\"
'}'
],
\"renewal\" : [
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"dns\"
'}',
'{'
\"name\" : \"email-forward\"
'}',
'{'
\"name\" : \"ssl-cert\"
'}'
],
\"id\" : \"porkbun\",
\"name\" : \"Porkbun\",
\"price\" : \"5.96\",
\"prices\" : '{'
\"register\" : \"4.96\",
\"renewal\" : \"5.96\"
'}',
\"pricetype\" : \"renewal\",
\"threeYearValueScore\" : \"18.36\"
'}'
],
\"transfer\" : [
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"dns\"
'}'
],
\"id\" : \"godaddy\",
\"name\" : \"GoDaddy\",
\"notes\" : '{'
\"feeTax\" : [
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"~\",
\"amountRateType\" : \"percent-varies-by-location\",
\"appliesToCustomers\" : [
\"eu\"
],
\"type\" : \"vat\"
'}',
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"15\",
\"amountRateType\" : \"percent\",
\"appliesToCustomers\" : [
\"in\"
],
\"type\" : \"gst\"
'}',
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"10\",
\"amountRateType\" : \"percent\",
\"appliesToCustomers\" : [
\"au\"
],
\"type\" : \"gst\"
'}'
]
'}',
\"price\" : \"11.99\",
\"prices\" : '{'
\"register\" : \"6.49\",
\"renewal\" : \"11.99\",
\"transfer\" : \"11.99\"
'}',
\"pricetype\" : \"transfer\",
\"threeYearValueScore\" : \"3.46\"
'}'
]
'}',
\"currency\" : \"USD\",
\"median\" : '{'
\"register\" : \"6.48\",
\"renewal\" : \"10.78\",
\"transfer\" : \"11.99\"
'}',
\"name\" : \"co.uk\",
\"registrarsIncluded\" : 4,
\"registrarsTotal\" : 47
'}',
'{'
\"average\" : '{'
\"register\" : \"8.90\",
\"renewal\" : \"14.10\",
\"transfer\" : \"9.30\"
'}',
\"cheapest\" : '{'
\"register\" : [
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"dns\"
'}',
'{'
\"name\" : \"whois-privacy\"
'}'
],
\"id\" : \"godaddy\",
\"name\" : \"GoDaddy\",
\"notes\" : '{'
\"feeIcann\" : '{'
\"addedToListPrice\" : true,
\"amount\" : \"0.18\"
'}',
\"feeTax\" : [
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"~\",
\"amountRateType\" : \"percent-varies-by-location\",
\"appliesToCustomers\" : [
\"eu\"
],
\"type\" : \"vat\"
'}',
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"15\",
\"amountRateType\" : \"percent\",
\"appliesToCustomers\" : [
\"in\"
],
\"type\" : \"gst\"
'}',
'{'
\"addedToListPrice\" : false,
\"amountRate\" : \"10\",
\"amountRateType\" : \"percent\",
\"appliesToCustomers\" : [
\"au\"
],
\"type\" : \"gst\"
'}'
]
'}',
\"price\" : \"3.17\",
\"priceOriginal\" : \"10.18\",
\"prices\" : '{'
\"register\" : \"3.17\",
\"renewal\" : \"20.17\",
\"transfer\" : \"8.17\",
\"whoisPrivacy\" : \"0.00\"
'}',
\"pricesOriginal\" : '{'
\"register\" : \"10.18\"
'}',
\"pricetype\" : \"register\",
\"promo\" : '{'
\"amount\" : \"2.99\",
\"code\" : \"GDD2dom\",
\"start\" : \"2023-01-01T00:00:00\",
\"type\" : \"price\"
'}',
\"promos\" : [
'{'
\"amount\" : \"2.99\",
\"code\" : \"GDD2dom\",
\"start\" : \"2023-01-01T00:00:00\",
\"type\" : \"price\"
'}'
],
\"terms\" : '{'
\"limitPerCustomer\" : '{'
\"count\" : 1
'}'
'}',
\"threeYearValueScore\" : \"5.76\"
'}'
],
\"renewal\" : [
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"whois-privacy\"
'}',
'{'
\"name\" : \"dns\"
'}',
'{'
\"name\" : \"email-forward\"
'}',
'{'
\"name\" : \"ssl-cert\"
'}'
],
\"id\" : \"porkbun\",
\"name\" : \"Porkbun\",
\"price\" : \"9.73\",
\"prices\" : '{'
\"register\" : \"8.73\",
\"renewal\" : \"9.73\",
\"transfer\" : \"9.73\",
\"whoisPrivacy\" : \"0.00\"
'}',
\"pricetype\" : \"renewal\",
\"threeYearValueScore\" : \"16.03\"
'}'
],
\"transfer\" : [
'{'
\"currency\" : \"USD\",
\"freeFeatures\" : [
'{'
\"name\" : \"dns\"
'}',
'{'
\"name\" : \"whois-privacy\"
'}',
'{'
\"name\" : \"email-forward\"
'}'
],
\"id\" : \"namecheap\",
\"name\" : \"Namecheap\",
\"notes\" : '{'
\"feeIcann\" : '{'
\"addedToListPrice\" : true,
\"amount\" : \"0.18\"
'}'
'}',
\"price\" : \"7.16\",
\"prices\" : '{'
\"register\" : \"6.16\",
\"renewal\" : \"14.16\",
\"restore\" : \"13.98\",
\"transfer\" : \"7.16\",
\"whoisPrivacy\" : \"0.00\"
'}',
\"pricetype\" : \"transfer\",
\"terms\" : '{'
\"limitPerCustomer\" : '{'
\"count\" : 1
'}'
'}',
\"threeYearValueScore\" : \"10.15\"
'}'
]
'}',
\"currency\" : \"USD\",
\"median\" : '{'
\"register\" : \"10.95\",
\"renewal\" : \"10.95\",
\"transfer\" : \"9.95\"
'}',
\"name\" : \"com\",
\"registrarsIncluded\" : 5,
\"registrarsTotal\" : 59
'}'
],
\"errors\" : [],
\"seconds\" : 0.126,
\"status\" : \"SUCCESS\"
'}'
שיטות רשם
getIds
פונקציה זו מחזירה את כל מזהי הרשם, שכל אחד מהם מזהה באופן ייחודי רשם הרשום באופן פעיל ב- TLD-List.
נקודת קצה של API:https://api.tld-list.com/v1/registrar/getIds
זמן תגובה:< 1 second
פרמטרים של בקשה
ללא
אובייקט תגובה
| נתיב | סוג | תיאור |
|---|---|---|
data | array of strings | מערך של מזהי רשם מחרוזות. |
בקשה/תגובה לדוגמה
curl -X POST https://api.tld-list.com/v1/registrar/getIds -H 'Content-Type: application/json' -d ''{'\"apiKeyPublic\":\"MY_PUBLIC_KEY\",\"apiKeyPrivate\":\"MY_PRIVATE_KEY\"'}''
'{'
\"data\" : [
\"101domain\",
\"123reg\",
\"above.com\",
...
\"upflare\",
\"webnames.ca\"
],
\"errors\" : [],
\"seconds\" : 0.001,
\"status\" : \"SUCCESS\"
'}'