API Dokümantasyonu

v1.6

VeriDC WHOIS, WHOIS/RDAP sorgulamaları ve dinamik paylaşım görselleri için REST API sunar. Uç noktalar herkese açıktır; kimlik doğrulama gerektirmez.

GET

/api/lookup

Alan adı, IP adresi, ASN veya CIDR aralığı için WHOIS/RDAP bilgilerini sorgulayın. RDAP ve WHOIS paralel sorgulanır; yapılandırılmış alanlarda önce RDAP verisi kullanılır. İki ham yanıt da sonuca eklenir.

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
query	string	Zorunlu	—	Alan adı, IPv4/IPv6 adresi, ASN (ör. AS13335) veya CIDR aralığı. Alternatif parametre: q

Örnek istek

curl "https://your-domain.com/api/lookup?query=google.com"

Başarılı yanıt

{
  "status": true,
  "time": 1.23,
  "cached": false,
  "source": "rdap",
  "result": {
    "domain": "google.com",
    "registrar": "MarkMonitor Inc.",
    "registrarURL": "http://www.markmonitor.com",
    "ianaId": "292",
    "whoisServer": "whois.markmonitor.com",
    "creationDate": "1997-09-15T04:00:00Z",
    "expirationDate": "2028-09-14T04:00:00Z",
    "updatedDate": "2019-09-09T15:39:04Z",
    "status": [
      { "status": "clientDeleteProhibited", "url": "..." },
      { "status": "clientTransferProhibited", "url": "..." }
    ],
    "nameServers": ["ns1.google.com", "ns2.google.com", "ns3.google.com", "ns4.google.com"],
    "dnssec": "unsigned",
    "domainAge": 28,
    "remainingDays": 945,
    "rawWhoisContent": "Domain Name: GOOGLE.COM\nRegistry Domain ID: ...",
    "rawRdapContent": "{\n  \"objectClassName\": \"domain\",\n  ...\n}"
  }
}

Hata yanıtı

{
  "status": false,
  "time": 0.45,
  "error": "No match for domain \"EXAMPLE.INVALID\""
}

GET

/api/og

WHOIS bilgileriyle dinamik paylaşım görseli oluşturun. /api/lookup üzerinden sorgular ve PNG görseli döndürür.

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
query	string	İsteğe bağlı	—	Sorgulanıp görselde gösterilecek alan adı, IP, ASN veya CIDR. Alternatif parametre: q
w	number	İsteğe bağlı	1200	Piksel cinsinden görsel genişliği (200–4096)
h	number	İsteğe bağlı	630	Piksel cinsinden görsel yüksekliği (200–4096)
theme	string	İsteğe bağlı	light	Renk teması: "light" veya "dark"

Örnek istek

curl "https://your-domain.com/api/og?query=google.com&theme=dark" -o og.png

Önizleme

/api/og?query=google.com

Sorgu sınırları ve önbellek

Redis yapılandırıldığında başarılı sorgular sunucuda önbelleğe alınır. Yanıtlarda şu başlıklar kullanılır:

Cache-Control: s-maxage=3600, stale-while-revalidate=86400

headers.

Önbellekteki yanıtların JSON verisinde şu alan bulunur:

"cached": true

ve süre şu alanla belirtilir:

"time": 0

Next Whois v1.6 · GitHub