API-Dokumentation

Endpoint

Antwortschema

interface DomainLookup {
  // Registry-derived fields below are omitted when available is true.
  id?:               string;
  domain:            string;
  available:         boolean | null; // null: DNS-only check, see maybeAvailable
  checkMethod?:      "rdap" | "whois43" | "dns";
  maybeAvailable?:   boolean; // true when DNS found no delegation but availability is unconfirmed
  ldhName?:          string | null;
  unicodeName?:      string | null;
  handle?:           string | null;
  rdapServer?:       string | null;
  secureDNS?:        boolean | null;
  delegationSigned?: boolean | null;
  lookedUpAt?:       string; // ISO 8601
  registryBusy?:     { retryAt: string }; // last known answer, the registry was busy
  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
}

Wenn available true ist (Domain nicht registriert), enthält die Antwort nur domain, available und die vier Arrays. Die vom Register stammenden Felder (id, ldhName, unicodeName, handle, rdapServer, secureDNS, delegationSigned, lookedUpAt) werden weggelassen.

Codebeispiele

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

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

OpenAPI-Spezifikation (JSON)

Rate-Limiting

Anonyme Anfragen werden pro IP-Adresse begrenzt. Mit einem API-Schlüssel zählen Aufrufe zu einem monatlichen Kontingent, das Ihr Plan festlegt.

Der 429-Antwort-Body enthält ein retryAfter-Feld (Unix ms). Jeder Aufruf mit Schlüssel liefert X-Quota-Limit (das Monatskontingent) und X-Quota-Remaining (verbleibende Aufrufe nach diesem). Das Kontingent wird am 1. jedes Monats zurückgesetzt (UTC).

HTTP-Statuscodes

Authentifizierung

Erstellen Sie einen kostenlosen API-Schlüssel in Ihrem Dashboard. Übergeben Sie ihn im Authorization-Header als Bearer-Token. Schlüssel können ein optionales Ablaufdatum haben und jederzeit widerrufen werden.

FAQ