Documentation API

Interrogez la disponibilité des domaines et les données RDAP depuis vos applications. Aucun compte requis pour un usage basique.

URL de basehttps://api.domain-sentinel.com

Endpoint

GET/v1/lookup/{domain}

Retourne les données RDAP d'un domaine. Les résultats sont mis en cache jusqu'à une semaine ; le cache est partagé entre tous les appelants.

Paramètre	Emplacement	Description
domain	path	Nom de domaine complet avec TLD (ex. github.com).
Authorization	header	Optionnel. Bearer <clé_api> pour s'authentifier et lever la limite IP.

Schéma de réponse

interface DomainLookup {
  // Registry-derived fields below are omitted when available is true.
  id?:               string;
  domain:            string;
  available:         boolean;
  ldhName?:          string | null;
  unicodeName?:      string | null;
  handle?:           string | null;
  rdapServer?:       string | null;
  secureDNS?:        boolean | null;
  delegationSigned?: boolean | null;
  lookedUpAt?:       string; // ISO 8601
  entities:          Entity[];
  nameservers:       Nameserver[];
  statuses:          string[];
  events:            Event[];
}

interface Entity {
  role:         string;
  handle:       string | null;
  name:         string | null;
  organization: string | null;
  ianaId:       string | null;
  abuseEmail:   string | null;
  abusePhone:   string | null;
}

interface Nameserver {
  ldhName: string;
  ipv4:    string[];
  ipv6:    string[];
}

interface Event {
  eventAction: string;
  eventDate:   string | null; // ISO 8601
}

Quand available vaut true (domaine non enregistré), la réponse ne contient que domain, available et les quatre tableaux. Les champs issus du registre (id, ldhName, unicodeName, handle, rdapServer, secureDNS, delegationSigned, lookedUpAt) sont omis.

Champ	Type	Description
available	boolean	true si le domaine n'est pas enregistré.
ldhName	string \| null	Nom de domaine en forme LDH (lettres-chiffres-tirets).
unicodeName	string \| null	Nom de domaine sous forme Unicode (IDN).
handle	string \| null	Identifiant unique au registre.
rdapServer	string \| null	URL du serveur RDAP utilisé pour cette requête.
secureDNS	boolean \| null	true si le domaine a des enregistrements DNSSEC.
delegationSigned	boolean \| null	true si la délégation est signée.
lookedUpAt	string	Horodatage ISO 8601 de la récupération des données.
entities	Entity[]	Registrar, titulaire et contacts.
nameservers	Nameserver[]	Serveurs de noms avec adresses IP optionnelles.
statuses	string[]	Codes de statut EPP (ex. clientTransferProhibited).
events	Event[]	Événements de registre : enregistrement, expiration, dernière modification, etc.

Exemples de code

# Anonymous (rate-limited)
curl https://api.domain-sentinel.com/v1/lookup/github.com

# With API key (unlimited)
curl -H "Authorization: Bearer ds_your_api_key" \
  https://api.domain-sentinel.com/v1/lookup/github.com

Limites de débit

Les requêtes anonymes sont limitées par adresse IP. Authentifiez-vous avec une clé API pour supprimer la limite.

Mode	Limite	En cas de dépassement
Anonyme (sans clé)	5 req/min et 50 req/jour par IP	HTTP 429
Authentifié (clé API)	Illimité	N/A

Le corps de la réponse 429 contient un champ retryAfter (Unix ms).

Codes HTTP

200	Succès. Objet domaine retourné.
400	Requête invalide : nom de domaine mal formé.
401	Clé API fournie mais invalide ou révoquée.
404	TLD non supporté : aucun serveur RDAP n'est répertorié pour cette extension dans le bootstrap IANA.
429	Limite de débit dépassée. Voir le champ retryAfter.
502	Le serveur RDAP du TLD est injoignable.

Authentification

Créez une clé API gratuite depuis votre tableau de bord. Transmettez-la dans le header Authorization en tant que token Bearer. Les clés peuvent avoir une date d'expiration et peuvent être révoquées à tout moment.

Créer une clé API

FAQ

Quels TLD sont supportés ?

Tout TLD disposant d'un serveur RDAP public référencé dans le fichier bootstrap de l'IANA. La liste est actualisée quotidiennement. Consultez-la sur la page des TLD.

Quelle est la fraîcheur des données ?

Les résultats sont mis en cache jusqu'à 7 jours. Les utilisateurs authentifiés peuvent forcer une actualisation via la page de recherche du tableau de bord, une fois toutes les 24 heures.

Que signifie une erreur 502 ?

Le serveur RDAP du registre n'a pas répondu. Il s'agit d'un problème temporaire côté registre, pas d'une panne Domain Sentinel. Réessayez dans quelques minutes.

L'API est-elle gratuite ?

Oui. Tous les comptes ont un accès illimité. Les limites de débit s'appliquent uniquement aux requêtes anonymes (sans clé).

Vous cherchez la liste des extensions supportées ? Voir tous les TLD