API Dokumentation

Technische Referenz für die DoDNS.info API mit Endpoints, Parametern, Beispielen und typischen Antworten.

Basis URL

https://dodns.info/api.php

Die API wird per API-Key abgesichert. Der Key kann per Query-Parameter oder Header übergeben werden.

?key=DEIN_API_KEY

X-API-Key: DEIN_API_KEY

GET /api.php?endpoint=health&key=DEIN_API_KEY

GET /api.php?endpoint=dns&domain=example.de&key=DEIN_API_KEY

Parameter	Pflicht	Beschreibung
`endpoint`	ja	`health` oder `dns`
`domain`	bei dns	Zu prüfende Domain
`key`	ja*	API-Key, wenn kein Header verwendet wird
`ttl`	nein	Cache-Zeit in Sekunden
`refresh`	nein	`1` erzwingt neue Prüfung

curl "https://dodns.info/api.php?endpoint=dns&domain=meersys.de&key=DEIN_API_KEY"

Jede Antwort enthält Header mit dem aktuellen Limit-Status. Bei Überschreitung liefert die API 429 zusammen mit Retry-After.

Header	Beschreibung
`X-RateLimit-Limit`	Maximale Anzahl Requests pro Zeitfenster (60s)
`X-RateLimit-Remaining`	Verbleibende Requests im aktuellen Fenster
`X-RateLimit-Reset`	Unix-Timestamp, wann das Fenster zurückgesetzt wird
`Retry-After`	Nur bei `429`: Sekunden bis zum nächsten Versuch

Jede Antwort enthält eine eindeutige meta.request_id (auch als X-Request-Id Header) – für Rückfragen beim Support bitte mit angeben.