API v1 Dokümantasyon
Desteklenen yöntemler, parametreler, döndürülen veriler ve örnekler hakkında bilgiler.
Genel Bilgiler
- Genel Bakış
- Kimlik Doğrulama
- Yanıt
- Ortak Yanıt Nesneleri
- RegistrarPricing
- RegistrarPromo
- Hata Kodları
- Sınırlar
Uzatma Yöntemleri
Kayıt Yöntemleri
Genel Bakış
TLD-List v1 API, TLD-List adresinde görüntülenen verileri canlı veritabanından almak için kullanılabilir.
API, JSON verileri içeren HTTP POST'ları kabul eder ve JSON verileriyle yanıt verir. Tüm API yöntemi istekleri için gereksinimler:
- İstekler HTTP POST yöntemi kullanılarak yapılmalıdır
- İstekler, kimlik doğrulama için geçerli bir genel ve özel API anahtar çifti içeren bir JSON gövdesine sahip olmalıdır
- İstekler şu başlığı içermelidir:
Content-Type: application/json
Parametreler, JSON kodlu istek gövdesinde anahtar/değerler olarak API'ye aktarılır.
Tüm API istekleri için temel URL şöyledir:
https://api.tld-list.com/v1
Kimlik Doğrulama
Kimlik doğrulama, yöntem URL'sine gönderilen JSON gövdesinde genel bir API anahtarı ve özel bir API anahtarı geçirilerek gerçekleştirilir. Tüm API çağrıları geçerli bir API anahtar çifti içermelidir. API anahtar çiftleri TLD-List hesabınızda API sekmesi altında oluşturulabilir.
API anahtarları oluşturmak için Hesap > API'yi ziyaret edin.
API anahtarları JSON istek gövdesinde apiKeyPublic (genel anahtarınız) ve apiKeyPrivate (özel anahtarınız) parametreleri kullanılarak iletilir.
Example authentication parameters
{
"apiKeyPublic":"MY_PUBLIC_KEY",
"apiKeyPrivate":"MY_PRIVATE_KEY"
}
Yanıt
Tüm başarılı API yanıtları 200 SUCCESS HTTP durum koduna ve JSON kodlu bir gövdeye sahip olacaktır. Yanıttaki diğer HTTP durum kodları isteğin başarısız olduğunu ve bir hata oluştuğunu gösterir.
API tarafından döndürülen JSON yanıt nesneleri aşağıdaki yapıya sahip olacaktır:
| Anahtar | Tip | Açıklama |
|---|---|---|
status |
string | İsteğin durumunu belirtir. SUCCESS, API çağrısının başarılı olduğunu, FAIL ise isteğin başarısız olduğunu gösterir. |
errors |
array of objects | Oluşan hataları temsil eden nesneler dizisi. Her hata nesnesi şunları içerecektir:kod: hata türünü tanımlayan dizemesaj: hatayı açıklayan insan tarafından okunabilir dizeparametre: istekte aktarılan belirli parametre(ler) ile ilgili bir sorunu belirten isteğe bağlı dize veya dizeler dizisi.Herhangi bir hata oluşmadıysa, hata dizisi boş olacaktır.Daha fazla bilgi için Hata Kodları bölümüne bakın. |
seconds |
number | API sunucusunun bir yanıt oluşturmak için harcadığı süre (saniye cinsinden). |
data |
string|array|object | İstenen verileri içeren bir nesne, dizi veya dize. |
Hataları içeren örnek başarısız yanıt nesnesi
{
"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"
}
Örnek başarılı yanıt nesnesi
{
"data" : [
{
"cheapest" : {
"renewal" : [
{
"id" : "sav",
"name" : "Sav",
"price" : "8.38"
}
],
},
"currency" : "USD",
"name" : "com",
"registrarsIncluded" : 58,
"registrarsTotal" : 58
}
],
"errors" : [],
"seconds" : 0.001,
"status" : "SUCCESS"
}
Ortak Yanıt Nesneleri
API yöntemlerinden bazıları aynı yapıya sahip veri nesneleri döndürür. Bu ortak veri nesneleri aşağıda ayrıntılı olarak açıklanmıştır.
RegistrarPricing
Özel şartlar, ücretler, vergi ve promosyonlar gibi ek ayrıntılar da dahil olmak üzere, bir kayıt kuruluşunun belirli bir fiyat türü (register, renewal, transfer) için bir uzantıya yönelik perakende fiyatlandırmasını açıklar.
| Yol | Tip | Açıklama | |
|---|---|---|---|
id |
string | Kayıt kuruluşunu benzersiz bir şekilde tanımlayan kayıt kuruluşu kimliği dizesi. | |
name |
string | Kayıt kuruluşunun görünen adı. | |
price |
string |
Kayıt kuruluşunun uzantı ve fiyat türü için nihai perakende satış fiyatı. Not: Bu alan yalnızca RegistrarPricing nesnesi bir fiyat türü bağlamında yuvalandığında (örneğin getCheapestRegistrars yanıtında) bulunur. |
|
priceOriginal |
string |
Sayısal bir dize olarak uzantı için kayıt kuruluşunun normal perakende satış fiyatı. Bu alan yalnızca fiyat promosyonel bir fiyatsa mevcut olacaktır.Not: Bu alan yalnızca RegistrarPricing nesnesi bir pricetype bağlamında yuvalandığında (örneğin getCheapestRegistrars yanıtında) bulunur. |
|
pricetype |
string |
Uzantı fiyatlandırma türü, şunlardan biri: register, renewal, transfer.Not: Bu alan yalnızca RegistrarPricing nesnesi bir pricetype bağlamında yuvalandığında (örneğin getCheapestRegistrars yanıtında) bulunur. |
|
prices |
object | Kayıt kuruluşunun tüm fiyat türleri için uzantıya yönelik perakende fiyatı. | |
prices[pricetype] |
string |
Kayıt kuruluşunun uzantı için nihai perakende satış fiyatı ve [ pricetype], burada [pr icetype] anahtarı register, renewal, transfer, restore, whoisprivacy şeklindedir. Örnek:{
"register": "8.73",
"renewal": "9.73",
"transfer": "9.73",
"whoisPrivacy": "0.00"
}
|
|
pricesOriginal |
object |
Kayıt kuruluşunun tüm fiyat türleri için uzantıya yönelik normal perakende fiyatı. Kayıt kuruluşunun etkin promosyonları yoksa bu alan mevcut olmayacaktır.
|
|
pricesOriginal[pricetype] |
string |
Kayıt kuruluşunun uzantı için normal perakende satış fiyatı ve [ pricetype], burada [pr icetype] anahtarı register, renewal, transfer, restore, whoisprivacy şeklindedir.
|
|
promo |
object |
Bu uzantı ve fiyat türü için kayıt kuruluşunun fiyatına uygulanan promosyon fiyatlandırmasını temsil eden bir RegistrarPromo nesnesi. Herhangi bir promosyon uygulanmamışsa bu alan mevcut olmayacaktır. Örnek promosyon nesnesi: {
"code": "MYCOUPONCODE",
"amount": "20.00",
"type": "discount-percent",
"start": "2015-06-22T00:00:00",
"end": "2025-06-22T00:00:00"
}Not: Bu alan yalnızca RegistrarPricing nesnesi bir fiyat türü bağlamında yuvalandığında (örneğin getCheapestRegistrars yanıtında) bulunur. |
|
promos |
array of objects | Bu uzantı için kayıt kuruluşu tarafından sunulan tüm etkin promosyon fiyatlarını temsil eden RegistrarPromo nesneleri dizisi. | |
terms |
object |
Kayıt kuruluşunun fiyatlandırması için geçerli olan özel şartları temsil eden nesneler koleksiyonu. Hiçbir özel koşul uygulanmıyorsa, bu alan mevcut olmayacaktır. Her alt nesne bir terim kimliği ile anahtarlanır: limitPerCustomer - fiyatlandırmanın yalnızca müşteri başına belirli sayıda alan adı için geçerli olduğunu belirtir.newCustomerOnly - fiyatlandırmanın yalnızca yeni müşteriler için geçerli olduğunu belirtir.affiliateLink - fiyatlandırmanın yalnızca müşteri bir bağlı kuruluş bağlantısı aracılığıyla kayıt kuruluşunun sitesine eriştiğinde geçerli olduğunu belirtir. nameserverLockIn - satın alınan alan adlarının yalnızca kayıt kuruluşunun ad sunucularını kullanabileceğini belirtir.idSubmissionRequired - müşterinin satın alma işlemini tamamlamak için fotoğraflı kimliğini veya işletme kaydını göndermesi gerektiğini belirtir.Örnek terim nesneleri: {
"limitPerCustomer": {
"pricetype": [
"register"
],
"count": 1
},
"newCustomerOnly": {
"pricetype": [
"register"
]
},
"affiliateLink": {
"pricetype": [
"register"
]
},
"multiYearPurchaseRequired": {
"pricetype": [
"register"
],
"count": 2
},
"nameserverLockIn": {
"pricetype": [
"register",
"renewal",
"transfer"
]
},
"idSubmissionRequired": {
"pricetype": [
"register",
"renewal",
"transfer"
]
}
}
|
|
terms[term].count |
number |
Terimin müşteriyi sınırladığı miktar. Örneğin, count = 1 ise, müşteri belirtilen fiyattan 1 alan adı ile sınırlandırılır. Geçerli değilse bu alan mevcut olmayacaktır.
|
|
terms[term].pricetype |
array of strings |
Terimin uygulandığı fiyat türü/türleri: register, renewal, transfer. Bu alan yalnızca RegistrarPricing nesnesinin pricetype'ı belirtilmemişse mevcut olacaktır.
|
|
notes |
object |
Kayıt kuruluşunun fiyatlandırmasıyla ilgili notları temsil eden bir nesne koleksiyonu. Fiyatlandırma notu yoksa, bu değer boş bir nesne olacaktır. Her alt nesne bir nota kimliği ile anahtarlanır: currencyExchangeRate, feeIcann, feeTax, feePayment
|
|
notes.feeIcann |
object |
TLD için nihai fiyata bir ICANN ücretinin eklenip eklenmediğini belirtir (genellikle 0,18 ABD doları USD). Bu not mevcutsa, kayıt kuruluşunun ICANN ücretini ilan edilen fiyatına dahil etmediği ve bunun yerine müşteri ödeme sırasında TLD's fiyatına ek bir ücret olarak eklediği anlamına gelir. Örnek fee_icann not nesnesi: {
"feeIcann": {
"pricetype": [
"register",
"renewal",
"transfer"
],
"amount": "0.18",
"addedToListPrice": true
}
}pricetype alanı hangi fiyat türlerinin ücrete tabi olduğunu belirtir ve addedToListPrice alanı ücretin nihai fiyata eklendiğini gösterir.
|
|
notes.feeTax |
array of objects |
Bir kayıt kuruluşu tarafından alınan çeşitli vergi oranlarını, verginin uygulandığı müşterileri ve hesaplanan verginin TLD için nihai fiyata dahil edilip edilmediğini belirtir. Vergilerin TLD'nin nihai fiyatına yalnızca kayıt operatörünün ilan edilen fiyatlarına vergiyi dahil etmemesi ve verginin tüm müşterilerden tahsil edilmesi durumunda dahil edildiğini lütfen unutmayın. Örnek feeTax nesne dizisi: {
"feeTax": [
{
"addedToListPrice": false,
"appliesToCustomers": [
"eu",
"us",
"in"
],
"amountRateType": "percent",
"amountRate": "13",
"type": "hst"
},
{
"addedToListPrice": false,
"appliesToCustomers": [
"ca"
],
"amountRateType": "percent",
"amountRate": "5",
"type": "gst"
}
]
}
|
|
notes.feeTax[].type |
string | Vergi türünü tanımlayan etiket, örneğin Katma Değer Vergisi için 'vat', Mal ve Hizmet Vergisi için 'gst ' vb. |
|
notes.feeTax[].amountRate |
number|string | Vergi oranı tutarı. Bu, ya bir sayı olarak vergi yüzdesi oranı ya da vergi oranının konum gibi müşteri kriterlerine göre değiştiğini belirten '~' dizesi olacaktır. |
|
notes.feeTax[].amountRateType |
string | 'percent' dize değeri, amountRate değerinin sayısal bir yüzde olduğunu belirtir. 'percent-varies-by-location' dize değeri, vergi oranının müşterinin faturalandırma bölgesine veya ülkesine göre değiştiğini belirtir. |
|
notes.feeTax[].appliesToCustomers |
string|array of strings | '*' dizesi verginin tüm müşteriler için geçerli olduğunu gösterir. Aksi takdirde bu değer, hangi ülkelerin vergiye tabi olduğunu tanımlayan ISO 3166-1 alpha-2 ülke kodu dizelerinden oluşan bir dizi olacaktır. Dikkat edilmesi gereken bir istisna: dizi, Avrupa Birliği'ndeki tüm ülkeleri temsil eden ülke kodu olmayan 'eu' dizesini içerebilir. |
|
notes.feeTax[].addedToListPrice |
boolean | Hesaplanan vergi tutarının nihai fiyata eklenip eklenmediğini gösterir. | |
notes.feePayment |
object | Kayıt kuruluşunun müşterinin ödeme yöntemine göre ek bir ücret alıp almadığını ve ücretin TLD için nihai fiyata dahil edilip edilmediğini belirtir. Örnek feePayment nesnesi: {
"feePayment": {
"addedToListPrice": false,
"amountRate": "~",
"amountRateMin": "0.9",
"amountRateMax": "20",
"amountRateType": "percent-varies-by-method"
}
} |
|
notes.feePayment.amountRate |
string | Ücret tutarı. Bu, bir sayı olarak ücret yüzdesi oranı veya ücret oranının ödeme yöntemi gibi müşteri kriterlerine göre değiştiğini belirten '~' dizesi olacaktır. |
|
notes.feePayment.amountRateMin |
string | Minimum ücret tutarı, yalnızca ücret değişken ise geçerlidir. | |
notes.feePayment.amountRateMax |
string | Maksimum ücret tutarı, yalnızca ücretin değişken olması durumunda geçerlidir. | |
notes.feePayment.amountRateType |
string | 'percent' dize değeri, amountRate değerinin sayısal bir yüzde olduğunu belirtir. 'percent-varies-by-method' dize değeri, ücretin müşterinin ödeme yöntemine göre değişen bir yüzde olduğunu belirtir. |
|
notes.feePayment.addedToListPrice |
boolean | Hesaplanan ücret tutarının nihai fiyata eklenip eklenmediğini gösterir. | |
notes.currencyExchangeRate |
object | Kayıt kuruluşunun fiyatlarının başka bir ulusal para biriminde listelendiğini ve USD'a dönüştürüldüğünü belirtir. Para birimi dönüşümünün ayrıntıları şu şekilde gösterilir:base: 3 harfli bir kod olarak kayıt kuruluşunun fiyatlandırma para birimi (örn. EUR)quote: fiyatların dönüştürüldüğü para birimi (her zaman USD olacaktır)rate: para birimi dönüşümünü yapmak için kullanılan dövizkuru. Örnek currencyExchangeRate not nesnesi: {
"currencyExchangeRate": {
"base": "GBP",
"quote": "USD",
"rate": "1.2482"
}
} |
|
threeYearValueScore |
number | Kayıt kuruluşu aracılığıyla 3 yıllık bir süre için bu uzantıya sahip bir alan adına sahip olmak için fiyatlandırma ve ücretsiz özelliklerle belirlenen sayısal bir değer ölçümü. Sayı ne kadar büyükse, o kadar fazla değer sunulur. | |
currency |
string |
Fiyatlandırma verilerinin üç harfli ISO 4217 para birimi kodu. Bu değer şu anda yalnızca USD.
|
|
freeFeatures |
array of objects |
Kayıt kuruluşunun alan adı sahipliğiyle birlikte sunduğu ücretsiz özellikleri temsil eden bir nesne dizisi. Nesne, her özelliğin miktarını ve süresini içerir. Her nesne bir ücretsiz özellik kimliği ile anahtarlanır: dns - ücretsiz DNS hizmeti. whois-privacy - WHOISgizlilik hizmeti.email-account - ücretsiz e-posta hesapları.email-forward - ücretsiz e-posta yönlendirme.ssl-cert - ücretsiz temel SSL sertifikaları. Örnek ücretsiz özellik dizisi: [
{
"name": "dns"
},
{
"name": "whois-privacy"
},
{
"name": "email-account",
"count": 5
},
{
"name": "ssl-cert",
"duration": 365
}
]
|
|
freeFeatures[].count |
number | Kayıt kuruluşunun ücretsiz olarak sunduğu özelliğin miktarı. Geçerli değilse bu alan mevcut olmayacaktır. | |
freeFeatures[].duration |
number |
Özelliğin kayıt kuruluşu tarafından ücretsiz olarak sunulduğu gün sayısı. Süre = 365 ise, özellik 1 yıl boyunca ücretsiz olarak sunulur. Geçerli değilse bu alan mevcut olmayacaktır.
|
|
RegistrarPromo
Bir kayıt kuruluşu tarafından sunulan aktif bir promosyonu tanımlar. Örnek:
{
"code": "MYCOUPONCODE",
"amount": "20.00",
"type": "discount-percent",
"start": "2015-06-22T00:00:00",
"end": "2025-06-22T00:00:00"
}
| Yol | Tip | Açıklama | |
|---|---|---|---|
promo.code |
string | Müşterinin indirimli promosyonu almak için ödeme sırasında girmesi gereken promosyon kodu. | |
promo.amount |
string |
Promosyon fiyatlandırmasının sayısal tutarı. Promosyonun türüne bağlı olarak bu, indirimli fiyat(fiyat), normal fiyattan çıkarılan tutar (indirim) veya normal fiyattan çıkarılanyüzde tutarı (indirim yüzdesi) olabilir.
|
|
promo.type |
string |
Promosyonel fiyatlandırma türünü temsil eden bir dize. Aşağıdaki değerlerden biri olacaktır: price - promosyonun tutar alanının yeni indirimli fiyat olduğu anlamına gelirdiscount - uygulanan fiyatı elde etmek için promosyonun tutar alanının normal fiyattan çıkarıldığı anlamına gelirdiscount-percent - promosyonun tutar alanının bir yüzde olduğu ve uygulanan fiyatı elde etmek için yüzdenin normal fiyattan çıkarıldığı anlamına gelir.
|
|
promo.start |
string |
Promosyonun başladığı ISO 8601 tarih saati (UTC zaman dilimi). Belirli bir başlangıç tarihi yoksa mevcut olmayacaktır. Örnek: 2015-06-22T00:00:00
|
|
promo.end |
string |
Promosyonun ne zaman sona ereceğine dair ISO 8601 tarih saati (UTC zaman dilimi). Belirli bir bitiş tarihi yoksa mevcut olmayacaktır. Örnek: 2025-06-22T00:00:00
|
|
promo.pricetype |
array of strings |
Promosyonun geçerli olduğu fiyat türü/türleri: register, renewal, transfer. Not: Bu alan yalnızca bir fiyat türü bağlamında (örneğin getCheapestRegistrars yanıtında) yuvalandığında mevcuttur. |
|
Hata Kodları
İstek başarısız olduğunda, JSON yanıt nesnesi neyin yanlış gittiğini açıklayan bir veya daha fazla hata nesnesi içerebilir. Aşağıda, hata nesnesinin kod alanında ayarlanabilecek tanımlayıcı hata kodlarının kapsamlı olmayan bir listesi bulunmaktadır.
| Kod | Açıklama |
|---|---|
| 502 | API sunucusu geçici olarak kullanılamıyor. |
| RATE_LIMITED | İstemci API isteklerinin sayısı izin verilen maksimum değeri aştı. |
| INVALID_METHOD | İstenen API yöntemi mevcut değil. |
| SYSTEM | Bilinmeyen bir sistem hatası oluştu. |
| RESPONSE_TIMEOUT | API sunucusu yanıt oluştururken zaman aşımına uğradı. |
| PARAMETER_REQUIRED | Çağrılan yöntem için gerekli bir parametre istemci tarafından sağlanmadı. |
| ACCOUNT_INACTIVE | Müşterinin hesabı artık aktif değil ve API erişimi için abonelik yenilemesi gerekiyor. |
| NO_ACCESS | Müşterinin hesap düzeyi API erişimi sağlamaz. API erişimi için bir hesap yükseltmesi gereklidir. |
| AUTH_INVALID | Kimlik doğrulama başarısız oldu: sağlanan API anahtarları etkin değil veya geçersiz. |
| CLIENT_IPS_EXCEEDED | Sağlanan API anahtar çifti için API'ye erişmesine izin verilen maksimum benzersiz istemci IP'si aşıldı. |
| REQUEST_ENDED_BY_CLIENT | İstek, bir yanıt oluşturulamadan istemci tarafından sonlandırıldı. |
Sınırlar
API'nin kullanımı, kötüye kullanımı önlemek için belirli sınırlamalara tabidir. Bu kullanım sınırlamaları aşağıda gösterilmiştir ve önceden haber verilmeksizin değiştirilebilir.
| Tip | Açıklama |
|---|---|
| Hesap Başına API Anahtarları | 3 |
| Oran Sınırı | 100 15 dakika başına maksimum talep |
| API Anahtarı Başına İstemci IP Adresleri | 5 1440 dakika başına anahtar başına benzersiz istemci IP adresleri |
Uzatma Yöntemleri
get
Uzantıları ve bunlarla ilişkili fiyatlandırma ve ayrıntı verilerini döndürür. Bu yöntem, bu yöntem tarafından döndürülmeyen "En Ucuz Fiyat Geçmişi" verileri haricinde (geçmiş veriler için getAggregateHistory yöntemine bakın), bir veya daha fazla TLD ayrıntı sayfasında (örneğin, .com) görüntülenen verileri almaya benzer.
API uç noktası:https://api.tld-list.com/v1/extension/get
Yanıt süresi:~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions
İstek parametreleri
| Anahtar | Tip | Gerekli | Açıklama | |
|---|---|---|---|---|
extensions |
array of strings |
Hangi uzantıların alınacağını belirtir. Öncesinde bir nokta eklemeyin. Uzantı adları unicode veya punycode eşdeğeri olabilir. Atlanırsa, TLD-List adresinde listelenen tüm uzantılar döndürülür. Örnek: |
||
includeFields |
array of strings |
Anahtar adına göre döndürülecek belirli verileri belirtin. Bu parametrede gönderilmeyen anahtarlar atlanacaktır. Varsayılan olarak, mevcut tüm alanlar döndürülür. Kullanılabilir alanların listesi için yanıt tablosuna bakın. Yuvalanmış alanlar desteklenmez.
Örnek: |
||
excludeFields |
array of strings |
Anahtar adına göre hariç tutulacak cetain verilerini belirtin. Bu parametrede gönderilen anahtarlar atlanacaktır. Varsayılan olarak, hiçbir alan hariç tutulmaz. Kullanılabilir alanların listesi için yanıt tablosuna bakın. Yuvalanmış alanlar desteklenmez.
Örnek: |
||
includeRegistrars |
array of strings |
Sonuçlara dahil edilecek aktif kayıt operatörlerinin dize kimlikleri. TLD-List adresinde aktif olarak listelenen tüm kayıt operatörlerinin kimliklerinin bir listesini elde etmek için getIds yöntemini kullanın. Örnek: |
||
excludeRegistrars |
array of strings |
Sonuçlarda hariç tutulacak aktif kayıt operatörlerinin dize kimlikleri. TLD-List adresinde aktif olarak listelenen tüm kayıt operatörlerinin kimliklerinin bir listesini elde etmek için getIds yöntemini kullanın. Örnek: |
||
omitExtensionsWithoutRegistrars |
boolean |
Örnek: |
||
Yanıt nesnesi
| Yol | Tip | Açıklama | |
|---|---|---|---|
data |
array of objects | Uzantı adları dizisi. | |
data[].available |
object | TLD aşaması kullanılabilirlik tarihlerinin nesnesi. | |
data[].available.general |
object | Alan adı kaydının genel kullanıma açık olduğu ISO 8601 tarih saati (UTC zaman dilimi). | |
data[].available.sunrise |
object |
TLD's Sunrise aşamasını (ticari marka sahiplerinin ilgili alan adlarının tescili için başvurmaya başlayabilecekleri zaman) temsil eden başlangıç ve bitiş tarih aralıkları nesnesi. Örnek: {
"sunrise": {
"start": "2017-06-19T00:00:00.000Z",
"end": "2017-08-21T00:00:00.000Z"
}
}
|
|
data[].available.trademark |
object |
TLD's Ticari Marka aşamasını temsil eden başlangıç ve bitiş tarih aralıkları nesnesi (ticari marka sahiplerinin, markalarıyla eşleşen bir alan adı kaydedilirse Ticari Marka Takas Merkezi tarafından bilgilendirileceği dönem). Örnek: {
"trademark": {
"start": "2019-06-18T00:00:00.000Z",
"end": "2020-09-21T00:00:00.000Z"
}
}
|
|
data[].available.other |
array of objects |
TLD'nin çeşitli lansman aşamalarını ve bunların "Land Rush" ve "Qualified Launch Program" gibi tarih-saat aralıklarını temsil eden nesneler dizisi. Örnek: {
"other": [
{
"end": "2020-09-18T00:00:00.000Z",
"name": "Limited Community Priority Period",
"start": "2019-09-17T00:00:00.000Z",
"type": "limited-registration-period"
},
{
"end": "2018-07-03T00:00:00.000Z",
"name": "Restricted Land Rush 1",
"start": "2017-10-23T00:00:00.000Z",
"type": "limited-registration-period"
},
{
"end": "2019-09-16T00:00:00.000Z",
"name": "Invitation Priority Access",
"start": "2017-08-22T00:00:00.000Z",
"type": "limited-registration-period"
},
{
"end": "2017-08-21T00:00:00.000Z",
"name": "Qualified Launch Program",
"start": "2017-06-19T00:00:00.000Z",
"type": "qualified-launch-program"
}
]
}
|
|
data[].average |
object |
Dahil edilen kayıt operatörleri için fiyat türüne göre uzantının ortalama fiyatını içeren nesne. Örnek: {
"average": {
"register": "7.63",
"renewal": "13.63",
"transfer": "9.63"
}
}
|
|
data[].average[pricetype] |
string |
pricetype] anahtarının register, renewal, transfer, restore, whoisprivacy olduğu [pricetype] için sayısal bir dize olarak uzantının ortalama fiyatı.
|
|
data[].category |
string |
TLD'nin sınıflandırıldığı kategoriler. Dizideki her nesne bir kategoriyi temsil eder ve aşağıdaki alanları içerir:id - TLD-List tarafından dahili olarak kullanılan tamsayı kategori kimliği.idstr - alternatif dize kategori kimliği.name - İngilizce kategori adı.desc - İngilizce kategori açıklaması.Örnek kategori dizisi: [
{
"id": 4,
"idstr": "services",
"name": "Services",
"desc": "TLDs for representing the service industry."
},
{
"id": 6,
"idstr": "food",
"name": "Food & Drink",
"desc": "Domain extensions for dining, cooking, restaurants, and beverages."
}
]
|
|
data[].dnssecSupported |
boolean | Kayıt defterinin DNS bölgesi DNS Güvenlik Uzantılarını (DNSSEC) destekliyorsa. | |
data[].hasPremiumDomains |
object |
pricetype] anahtarları ve boolean değerlerinden oluşan nesne, kayıt defterinin belirli "premium" alan adları için daha yüksek fiyatlar talep edip etmediğini gösterir. Örnek: {
"hasPremiumDomains": {
"register": false,
"renewal": false
}
}
|
|
data[].infoUpdated |
string |
TLD's temel bilgilerinin (kısıtlamalar, kullanılabilirlik tarihleri, vb.) en son kontrol edildiği ve güncellendiği ISO 8601 tarih saati (UTC zaman dilimi). Not: Yeni bir updated.info tarihi, herhangi bir veri değişikliğinin gerçekleştiğini göstermez. Yalnızca verilerin en son ne zaman kontrol edildiğini ve ayarlandığını gösterir.
|
|
data[].intendedUsage |
string | Uzantının tescil ettirenler tarafından nasıl kullanılmasının beklendiği hakkında genel bilgi. | |
data[].language |
string | ISO 639-1 2 karakterli dil kodu. Dil İngilizce ise veya bilinmiyorsa, bu alan mevcut olmayacaktır. | |
data[].level |
integer | Uzantının etki alanı düzeyini temsil eden tamsayı. 1 = üst düzey alan adı, 2 = ikinci düzey alan adı, 3 = üçüncü düzey alan adı, vb. | |
data[].localPresenceRequired |
boolean | Tescil ettirenin bölgede yerel bir fiziksel adrese sahip olması gerekiyorsa. | |
data[].median |
object |
Dahil edilen kayıt operatörleri için fiyat türüne göre uzantının medyan fiyatını içeren nesne. Örnek: {
"median": {
"register": "3.17",
"renewal": "20.17",
"transfer": "8.17"
}
}
|
|
data[].median[pricetype] |
string |
pricetype] anahtarının register, renewal, transfer, restore, whoisprivacy olduğu [pricetype] için sayısal bir dize olarak uzantının medyan fiyatı.
|
|
data[].name |
string | Etki alanı uzantısının Unicode adı. | |
data[].nameservers |
array |
Kayıtlı alan adlarının yetkili ad sunucularını depolayan kayıt defterinin kök ad sunucuları. Örnek ad sunucuları dizisi: {
"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"
}
]
}
|
|
data[].parentTld |
string | Uzantının üst düzey alan adı. Bu bir TLD ise, bu alan mevcut olmayacaktır. | |
data[].pricingUpdated |
string |
TLD's kayıt kuruluşu fiyatlandırmasının en son kontrol edildiği ve güncellendiği ISO 8601 tarih saati (UTC zaman dilimi). Not: Yeni bir updated.pricing tarihi, herhangi bir veri değişikliğinin gerçekleştiğini göstermez. Yalnızca verilerin en son ne zaman kontrol edildiğini ve ayarlandığını gösterir.
|
|
data[].punycode |
string | Alan adı uzantısının Punycode adı. Yalnızca IDN uzantıları için mevcuttur. | |
data[].registerMaxYears |
integer | Satın alma sırasında bir alan adının kaydedilebileceği maksimum yıllar. | |
data[].registerMinYears |
integer | Satın alma sırasında bir alan adının kaydedilebileceği minimum yıllar. | |
data[].registrarsIncluded |
integer |
Döndürülen kayıt operatörleri dizisine dahil edilen kayıt operatörlerinin sayısı.
|
|
data[].registrarsTotal |
integer | Uzantıyı satan toplam aktif kayıt şirketi. | |
data[].registrars |
array of objects | Kayıt kuruluşu fiyatlandırma ve özellik verilerini içeren RegistrarPricing nesne(ler)i dizisi. | |
data[].registryUrl |
string | TLD kayıt bilgileri için kayıt kuruluşunun resmi web sitesi. | |
data[].renewalMinYears |
integer | Bir alan adının yenilenebileceği izin verilen minimum yıllar. | |
data[].restrictions |
string | TLD's kayıt kısıtlamaları ve gerekliliklerinin kısa bir açıklaması. Herhangi bir kısıtlama yoksa, bu alan mevcut olmayacaktır | |
data[].sponsor |
object | Uzantının sponsor kuruluşu veya yönetim kuruluşu hakkında veri içeren nesne. | |
data[].sponsor.name |
string | Uzantının ICANN onaylı sponsor kuruluşunun veya ccTLD yönetim kuruluşunun adı. | |
data[].sponsor.address |
string |
Sponsor kuruluşun veya ccTLD yönetim kuruluşunun fiziksel konumu. Örnek adres dizisi: {
"sponsor": {
"address": [
"Minerva House",
"Edmund Halley Road",
"Oxford Science Park",
"Oxford OX4 4DQ",
"United Kingdom"
]
}
}
|
|
data[].sponsorParentCompany |
string | Sponsor kuruluşta kontrol hissesine sahip olan kuruluşun adı. | |
data[].romanized |
string | TLD latin karakterlere dönüştürülmüştür. Dil İngilizce tabanlı ise veya bilinmiyorsa, bu alan mevcut olmayacaktır. | |
data[].rtl |
string | Uzantı "sağdan sola" okunuyorsa (örn. Arabric TLDs), bu değer şu şekilde olacaktır __true__. Eğer "soldan sağa" doğru okunursa, bu değer __false__. Bilinmiyorsa, bu değer mevcut olmayacaktır. | |
data[].syntax |
object | Uzantının izin verilen alan adı kuralları ve kısıtlamaları hakkında ayrıntılar içeren nesne. | |
data[].syntax.minChars |
integer | Etikette kaydedilmesine izin verilen minimum karakter sayısı. | |
data[].syntax.maxChars |
integer | Etikette kaydedilmesine izin verilen maksimum karakter sayısı. | |
data[].targetMarket |
string | TLD'nin hizmet etmesi amaçlanan kişi veya kuruluşlar. | |
data[].translation |
string | TLD'nin İngilizce çevirisi. TLD zaten İngilizce tabanlı ise veya çeviri bilinmiyorsa, bu değer mevcut olmayacaktır. | |
data[].type |
string |
Aşağıdaki dizelerden biriyle tanımlanan TLD türü:gTLD: genel üst düzey alan adı.ccTLD : ülke kodu üst düzey alan adı.grTLD: genel-kısıtlı üst düzey alan adı.sTLD: sponsorlu üst düzey alan adı. |
|
data[].wholesale |
object |
Fiyat türüne göre uzantının toptan fiyatlarını içeren nesne. Toptan fiyatlar, alan adı satın alımları için kayıt kuruluşu tarafından tahsil edilen fiyatlardır. Örnek: {
"wholesale": {
"register": "8.97",
"renewal": "8.97",
"transfer": "8.97"
}
}
|
|
data[].whoisPrivacySupported |
boolean | Uzantı, WHOIS Gizlilik hizmetlerinin kayıt ettirenlerin adlarını ve iletişim bilgilerini maskelemesine izin veriyorsa. Bilinmiyorsa, bu alan mevcut olmayacaktır. | |
data[].whoisServer |
boolean | Alan adı kayıt sahibinin iletişim bilgilerini depolayan kayıt sunucusunun ana bilgisayar adı. | |
Örnek istek/cevap
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
Tüm uzantı adlarını döndürür.
API uç noktası:https://api.tld-list.com/v1/extension/getNames
Yanıt süresi:~1 second
İstek parametreleri
| Anahtar | Tip | Gerekli | Açıklama | |
|---|---|---|---|---|
omitExtensionsWithoutRegistrars |
boolean |
true olduğunda, sonuçlarda kayıt kuruluşu fiyatlandırma verisi bulunmayan uzantılar atlanır. Varsayılan değer yanlıştır.
|
||
wantPunycode |
boolean |
Döndürülen tüm IDN uzantılarını unicode yerine punycode olarak kodlayın. Varsayılan değer false.
|
||
Yanıt nesnesi
| Yol | Tip | Açıklama | |
|---|---|---|---|
data |
array of strings | Uzantı adları dizisi. | |
Örnek istek/cevap
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
En ucuz alan adı kayıt şirketlerini/sağlayıcılarını, fiyatlarını, ortanca fiyatı ve alan adı uzantısı başına ortalama fiyatı döndürür. Herhangi bir kayıt şirketi tarafından satılmayan uzantılar döndürülmez.
API uç noktası:https://api.tld-list.com/v1/extension/getCheapestRegistrar
Yanıt süresi:~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions
İstek parametreleri
| Anahtar | Tip | Gerekli | Açıklama | |
|---|---|---|---|---|
pricetypes |
array of strings |
Alınacak fiyatlandırma türlerini belirtir. Atlanırsa, 3 fiyat türü ( Örnek: |
||
extensions |
array of strings |
Hangi uzantıların alınacağını belirtir. Öncesinde bir nokta eklemeyin. Uzantı adları unicode veya punycode eşdeğeri olabilir. Atlanırsa, TLD-List adresinde listelenen tüm uzantılar döndürülür. Örnek: |
||
includeRegistrars |
array of strings |
En ucuz fiyatlandırma ve toplu hesaplamalar belirlenirken dahil edilecek aktif kayıt operatörlerinin dize kimlikleri. Bu parametrede belirtilmeyen kayıt operatörleri yok sayılır. TLD-List adresinde aktif olarak listelenen tüm kayıt operatörlerinin kimliklerinin bir listesini elde etmek için getIds yöntemini kullanın. Bu parametre atlanırsa, TLD-List adresinde aktif olarak listelenen tüm kayıt operatörleri dikkate alınacaktır. Örnek: |
||
excludeRegistrars |
array of strings |
En ucuz fiyatlandırma ve toplu hesaplamalar belirlenirken hariç tutulacak aktif kayıt operatörlerinin dize kimlikleri. TLD-List adresinde aktif olarak listelenen tüm kayıt operatörlerinin kimliklerinin bir listesini elde etmek için getIds yöntemini kullanın. Bu parametre atlanırsa, hiçbir kayıt operatörü göz ardı edilmeyecektir. Örnek: |
||
omitExtensionsWithoutRegistrars |
boolean |
Örnek: |
||
Yanıt nesnesi
| Yol | Tip | Açıklama | |
|---|---|---|---|
data |
array of objects | Her biri bir etki alanı uzantısını temsil eden nesneler dizisi. | |
data[].name |
string | Etki alanı uzantısının Unicode adı. | |
data[].punycode |
string | Alan adı uzantısının Punycode adı. Yalnızca IDN uzantıları için mevcuttur. | |
data[].currency |
string |
Fiyatlandırma verilerinin üç harfli ISO 4217 para birimi kodu. Bu değer şu anda yalnızca USD.
|
|
data[].registrarsIncluded |
number | İade edilen fiyatlandırma verilerine dahil olan kayıt şirketlerinin sayısı. | |
data[].average |
object | Dahil edilen kayıt şirketleri için fiyat türüne göre uzantının ortalama fiyatını içeren nesne. | |
data[].average[pricetype] |
string |
pricetype] anahtarının register, renewal, transfer olduğu [pricetype] için sayısal bir dize olarak uzantının ortalama fiyatı.
|
|
data[].median |
object | Dahil edilen kayıt şirketleri için fiyat türüne göre uzantının medyan fiyatını içeren nesne. | |
data[].median[pricetype] |
string |
pricetype] anahtarının register, renewal, transfer olduğu [pricetype] için sayısal bir dize olarak uzantının medyan fiyatı.
|
|
data[].cheapest |
object | Fiyat türüne göre uzantı için en ucuz kayıt şirketlerini içeren nesne. | |
data[].cheapest[pricetype] |
array of objects |
Fiyat türü] anahtarının Bu veri bir dizidir çünkü uzantı için en ucuz fiyat birden fazla kayıt kuruluşunda aynı olabilir. |
|
Örnek istek/cevap
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"
}
Kayıt Yöntemleri
getIds
Her biri TLD-List adresinde aktif olarak listelenen bir kayıt kuruluşunu benzersiz bir şekilde tanımlayan tüm kayıt kuruluşu kimliklerini döndürür.
API uç noktası:https://api.tld-list.com/v1/registrar/getIds
Yanıt süresi:< 1 second
İstek parametreleri
Hiçbiri
Yanıt nesnesi
| Yol | Tip | Açıklama | |
|---|---|---|---|
data |
array of strings | Dize kayıt kuruluşu kimlikleri dizisi. | |
Örnek istek/cevap
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"
}