API-Dokumentation

Endpoint

Antwortschema

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
}

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 (unlimited)
curl -H "Authorization: Bearer ds_your_api_key" \
  https://api.domain-sentinel.com/v1/lookup/github.com

Rate-Limiting

Anonyme Anfragen werden pro IP-Adresse begrenzt. Authentifizieren Sie sich mit einem API-Schlüssel, um das Limit aufzuheben.

Der 429-Antwort-Body enthält ein retryAfter-Feld (Unix ms).

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