Whois API

RDAP ve WHOIS’i tek, normalize JSON yanıtında birleştiren ücretsiz REST API. Her uzantıda aynı alanlar; bilinmeyen değerler null, listeler boş dizi, tarihler UTC ISO 8601.

Temel adreshttps://whois.nomabilisim.com/apiBiçimJSONKimlik doğrulamaisteğe bağlıSınır120 istek/dk

GET

/v1/whois/{alanadi}

Tek alan adı sorgusu. Önce RDAP, yanıt yoksa WHOIS. Kısa biçim /{alanadi} de çalışır.

Parametre	Yer	Açıklama
alanadi	yol	Sorgulanacak alan adı (IDN desteklenir).
raw	sorgu	true ise normalize yanıt yerine ham RDAP JSON veya WHOIS metni döner.
Authorization	başlık	Bearer <anahtar>. Anahtarlı istekler hız sınırına takılmaz.

GET

/multi?domains=a.com,b.net

Toplu sorgu: virgülle ayrılmış en fazla 10 alan adı; yanıt { "results": [ ... ] }.

Parametre	Yer	Açıklama
domains	sorgu	Virgülle ayrılmış alan adı listesi. Eksikse 400 INVALID_DOMAIN.

Örnek istek

curl https://whois.nomabilisim.com/api/v1/whois/example.com

# Ham RDAP / WHOIS çıktısı
curl "https://whois.nomabilisim.com/api/v1/whois/example.com?raw=true"

# Toplu sorgu (en fazla 10 alan adı)
curl "https://whois.nomabilisim.com/api/multi?domains=example.com,example.net"

Yanıt şeması

200 yanıtı alan adı kayıtlı olsa da olmasa da döner; isRegistered durumu gösterir.

domainstringNormalize alan adı (punycode).

domainUnicodestring | nullIDN ise Unicode biçimi.

tldstringUzantı.

isRegisteredbooleanKayıtlıysa true.

registrar.name · ianaId · urlstring | nullKayıt firması bilgileri.

registrar.abuseEmail · abusePhonestring | nullKötüye kullanım iletişimi.

status[]string[]EPP durum kodları (RFC 5731).

nameservers[].name · ipv4[] · ipv6[]object[]Yetkili nameserver’lar ve glue adresleri.

dnssec.signed · dsData[]objectDNSSEC durumu ve DS kayıtları.

dates.created · updated · expiresISO 8601 | nullKayıt yaşam döngüsü tarihleri (UTC).

contacts.{registrant,admin,tech,billing}objectAd, kuruluş, e-posta, telefon, adres; gizliyse redacted: true.

meta.source · server · fetchedAt · cachedobjectVerinin kaynağı (rdap/whois) ve önbellek durumu.

Hata kodları

Tüm hatalar aynı zarfta gelir: { "error": { "code", "message", "query" } }

400INVALID_DOMAINGeçersiz veya çözümlenemeyen alan adı.

403UNAUTHORIZEDAPI anahtarı eksik veya hatalı (özel kurulumda).

429RATE_LIMITEDDakikalık sınır aşıldı. Retry-After başlığındaki süre kadar bekleyin.

501UNSUPPORTED_TLDBu uzantı için RDAP veya WHOIS kaynağı yok.

502UPSTREAM_ERRORKayıt otoritesi hatalı yanıt verdi.

504UPSTREAM_TIMEOUTKayıt otoritesi 5 saniye içinde yanıt vermedi.

Alan adınız, hosting’iniz ve sunucunuz tek yerdeNoma Bilişim’de kaydettiğiniz alan adlarını NomaCloud panelinden yönetin: DNS, otomatik yenileme, transfer kilidi ve Whois gizliliği dahil. Alan adı ara nomabilisim.com