Documentación API

Consulta disponibilidad de dominios y datos RDAP desde tus propias aplicaciones. No se requiere cuenta para uso básico.

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

Endpoint

GET/v1/lookup/{domain}

Devuelve datos RDAP de un dominio. Los resultados se almacenan en caché hasta una semana; la caché es compartida entre todos los usuarios.

Parámetro	Ubicación	Descripción
domain	path	Nombre de dominio completo con TLD (ej. github.com).
Authorization	header	Opcional. Bearer <clave_api> para autenticarse y eliminar el límite por IP.

Esquema de respuesta

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
}

Cuando available es true (dominio no registrado), la respuesta solo contiene domain, available y los cuatro arrays. Los campos provenientes del registro (id, ldhName, unicodeName, handle, rdapServer, secureDNS, delegationSigned, lookedUpAt) se omiten.

Campo	Tipo	Descripción
available	boolean	true si el dominio no está registrado.
ldhName	string \| null	Nombre de dominio en forma LDH (letras-dígitos-guiones).
unicodeName	string \| null	Nombre de dominio en forma Unicode (IDN).
handle	string \| null	Identificador único en el registro.
rdapServer	string \| null	URL del servidor RDAP usado para esta consulta.
secureDNS	boolean \| null	true si el dominio tiene registros DNSSEC.
delegationSigned	boolean \| null	true si la delegación está firmada.
lookedUpAt	string	Marca de tiempo ISO 8601 de cuándo se obtuvieron los datos.
entities	Entity[]	Registrar, titular y contactos.
nameservers	Nameserver[]	Servidores de nombres con direcciones IP opcionales.
statuses	string[]	Códigos de estado EPP (ej. clientTransferProhibited).
events	Event[]	Eventos del registro: registro, expiración, último cambio, etc.

Ejemplos de código

# 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

Límites de tasa

Las solicitudes anónimas tienen un límite por dirección IP. Autentícate con una clave API para eliminar el límite.

Modo	Límite	Al superar
Anónimo (sin clave)	5 req/min y 50 req/día por IP	HTTP 429
Autenticado (clave API)	Ilimitado	N/A

El cuerpo de la respuesta 429 incluye un campo retryAfter (Unix ms).

Códigos HTTP

200	Éxito. Objeto de dominio devuelto.
400	Solicitud incorrecta: nombre de dominio mal formado.
401	Clave API proporcionada pero inválida o revocada.
404	TLD no soportado: no hay ningún servidor RDAP listado para esta extensión en el bootstrap de IANA.
429	Límite de tasa superado. Ver el campo retryAfter.
502	El servidor RDAP del TLD no está disponible.

Autenticación

Crea una clave API gratuita en tu panel. Pásala en el header Authorization como token Bearer. Las claves pueden tener una fecha de expiración opcional y se pueden revocar en cualquier momento.

Crear una clave API

Preguntas frecuentes

¿Qué TLDs están soportados?

Cualquier TLD con un servidor RDAP público en el archivo bootstrap de la IANA. La lista se actualiza diariamente. Explórala en la página de TLDs.

¿Qué tan recientes son los datos?

Los resultados se almacenan en caché hasta 7 días. Los usuarios autenticados pueden forzar una actualización desde la página de búsqueda del panel, una vez cada 24 horas.

¿Qué significa un error 502?

El servidor RDAP del registro no respondió. Es un problema temporal del registro, no una interrupción de Domain Sentinel. Reintenta en unos minutos.

¿Es gratuita la API?

Sí. Todas las cuentas tienen acceso ilimitado. Los límites de tasa se aplican solo a las solicitudes anónimas (sin clave).

¿Buscas la lista de extensiones soportadas? Ver todos los TLDs