DKIM-Schlüsselprüfung

GET /api/v1/dkim/{domain}/{selector}

Holt selector._domainkey.domain als TXT und untersucht den DKIM-Schlüssel: Schlüsseltyp, Schlüssellänge sowie die Flags für widerrufen (leeres p=) und Testbetrieb (t=y). Wird kein DKIM-Record gefunden, kommt found=false zurück, ohne weitere Felder außer status (dem DNS-RCODE).

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
domain	string	ja	—
selector	string	ja	—

Antworten

Status	Typ	Beschreibung
200	DkimResult	Details zum DKIM-Schlüssel (oder found=false)
400	object	Fehler
429	object	Fehler
502	object	Fehler

Antwortkörper

Feld	Typ	Pflicht	Beschreibung
api	string	nein	—
domain	string	nein	—
selector	string	nein	—
name	string	nein	Abgefragter TXT-Name: selector._domainkey.domain
found	boolean	nein	—
status	integer	nein	DNS-RCODE; nur vorhanden, wenn found=false
valid	boolean	nein	—
revoked	boolean	nein	Schlüssel widerrufen (leeres p=-Tag)
testing	boolean	nein	Testbetrieb (t=y)
keyType	string	nein	(rsa, ed25519)
keyBits	integer | null	nein	—
record	string	nein	—

Beispiel

curl -X GET "https://dns-doctor.com/api/v1/dkim/<domain>/<selector>" \
  -H "Authorization: Bearer $REGFISH_API_KEY"

Anfrage zusammenstellen

Werte eintragen — der Aufruf unten passt sich an. Es wird nichts abgeschickt: die API gibt Browser-Anfragen von dieser Domain aus derzeit nicht frei (CORS). Der API-Key wird nicht gespeichert.