Domain Data API | REST, GraphQL, Rate Limits

API Architektur

Unsere API basiert auf REST-Prinzipien. Alle Antworten sind JSON-kodiert. Wir nutzen standardisierte HTTP Status-Codes und Authentifizierung via Bearer Token. Die Infrastruktur ist weltweit verteilt (Anycast), um die Latenz so gering wie möglich zu halten (< 100ms global).

Endpoints (High Level)

GET /v1/domains/{domain}/whois: Liefert aktuelle und historische Whois-Daten.
GET /v1/domains/{domain}/dns: Liefert aufgelöste DNS-Records (A, MX, TXT, etc.).
GET /v1/domains/{domain}/risk: Berechnet einen Risiko-Score basierend auf ML-Modellen.
POST /v1/search: Komplexe Suche (z.B. "Finde alle Domains, die 'bank' enthalten und in Russland gehostet werden").

Code Beispiel (Python/Requests)

import requests

url = "https://api.edi-data.org/v1/domains/google.com/whois"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(f"Registrar: {data['registrar']['name']}")
    print(f"Created Date: {data['created_date']}")
else:
    print("Error:", response.status_code)

Rate Limiting & Quotas

Wir nutzen ein "Token Bucket" Modell für Rate Limits. Jeder Key hat ein Limit (z.B. 10 Requests/Sekunde für Starter, 500/Sekunde für Enterprise). Header X-RateLimit-Remaining informieren Sie über Ihr aktuelles Kontingent. Bei Überschreitung erhalten Sie 429 Too Many Requests. Wir bieten dedizierte "High Volume" Instanzen für Partner mit extremen Anforderungen.

Versioning

Stabilität ist alles. Wir versionieren unsere API (v1, v2). Wir garantieren, dass wir keine "Breaking Changes" innerhalb einer Version einführen (z.B. Felder entfernen oder umbenennen). Neue Felder werden additiv hinzugefügt. Veraltete Versionen werden mindestens 12 Monate unterstützt (Depreciation Policy).