WNEXT WHOIS

API-Dokumentation

v1.6

Next Whois bietet eine einfache REST-API für programmatische WHOIS/RDAP-Abfragen und dynamische OG-Bildgenerierung. Alle Endpunkte sind öffentlich zugänglich und erfordern keine Authentifizierung.

GET
/api/lookup

WHOIS/RDAP-Informationen für eine Domain, IP-Adresse, ASN oder CIDR-Bereich abfragen. RDAP und WHOIS werden parallel abgefragt; strukturierte Felder bevorzugen RDAP-Daten mit Fallback auf WHOIS. Beide Rohantworten sind enthalten.

Parameter

ParameterTypErforderlichStandardBeschreibung
querystring
Erforderlich
—Domainname, IPv4/IPv6-Adresse, ASN (z.B. AS13335) oder CIDR-Bereich. Alias: q

Beispielanfrage

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

Erfolgsantwort

{
  "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}"
  }
}

Fehlerantwort

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

Dynamisches Open-Graph-Bild mit WHOIS-Details generieren. Fragt intern /api/lookup ab und rendert eine kartenförmige Zusammenfassung. Gibt ein PNG-Bild zurück.

Parameter

ParameterTypErforderlichStandardBeschreibung
querystring
Optional
—Domain, IP, ASN oder CIDR zum Nachschlagen und Anzeigen. Alias: q
wnumber
Optional
1200Bildbreite in Pixeln (200-4096)
hnumber
Optional
630Bildhöhe in Pixeln (200-4096)
themestring
Optional
lightFarbschema: "light" oder "dark"

Beispielanfrage

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

Vorschau

OG Image Preview

/api/og?query=google.com

Ratenbegrenzung & Caching
Erfolgreiche WHOIS-Abfrageantworten werden serverseitig (Redis) gecacht und mit
Cache-Control: s-maxage=3600, stale-while-revalidate=86400
Headern ausgeliefert.
Gecachte Antworten enthalten
"cached": true
im JSON-Body und melden
"time": 0
.

Next Whois v1.6 · whois