Documentation API

v1.6

Next Whois fournit une API REST simple pour les requêtes WHOIS/RDAP programmatiques et la génération dynamique d'images OG. Tous les points de terminaison sont publiquement accessibles et ne nécessitent aucune authentification.

GET

/api/lookup

Interroger les informations WHOIS/RDAP pour un domaine, une adresse IP, un ASN ou une plage CIDR. RDAP et WHOIS sont interrogés en parallèle ; les champs structurés préfèrent les données RDAP avec repli sur WHOIS. Les deux réponses brutes sont incluses.

Paramètres

Paramètre	Type	Requis	Défaut	Description
query	string	Requis	—	Nom de domaine, adresse IPv4/IPv6, ASN (ex. AS13335) ou plage CIDR. Alias : q

Exemple de requête

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

Réponse de succès

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

Réponse d'erreur

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

GET

/api/og

Générer une image Open Graph dynamique avec les détails WHOIS. Interroge en interne /api/lookup et rend un résumé sous forme de carte. Retourne une image PNG.

Paramètres

Paramètre	Type	Requis	Défaut	Description
query	string	Optionnel	—	Domaine, IP, ASN ou CIDR à rechercher et afficher. Alias : q
w	number	Optionnel	1200	Largeur de l'image en pixels (200-4096)
h	number	Optionnel	630	Hauteur de l'image en pixels (200-4096)
theme	string	Optionnel	light	Thème de couleur : "light" ou "dark"

Exemple de requête

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

Aperçu

/api/og?query=google.com

Limitation de débit et cache

Les réponses WHOIS réussies sont mises en cache côté serveur (Redis) et servies avec les en-têtes

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

Les réponses en cache incluent

"cached": true

dans le corps JSON et rapportent

"time": 0

Next Whois v1.6 · whois