Eine Domain jetzt prüfen
Prüft das DNS der Domain sofort und gibt sie mit dem Ergebnis der Prüfung zurück. Bei einer unverifizierten Domain sind das die Verifizierungseinträge, bei einer verifizierten die Signatureinträge und ob Mail von ihr gesendet werden kann. Kein Body.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /domains/{id}/verify
Prüft das DNS der Domain sofort und gibt sie mit dem Ergebnis der Prüfung zurück. Bei einer unverifizierten Domain sind das die Verifizierungseinträge, bei einer verifizierten die Signatureinträge und ob Mail von ihr gesendet werden kann. Kein Body.
Beispiel
Erfordert domains:write. Ein Key, der auf bestimmte Adressen oder Domains beschränkt ist, muss die ganze Domain halten.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/verify" -H "$AUTH"{ "object": "domain", "id": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "receiving": { "verified": true, "verifiedAt": "2026-09-25T10:14:40.000Z", "catchAll": true, "lastCheckedAt": "2026-09-25T10:14:40.000Z", "error": null }, ...}Eine Prüfung, die in den letzten 10 Sekunden lief, wird nicht wiederholt. Der Aufruf gibt dann die Domain im aktuellen Stand zurück, sodass ein Aufruf in einer engen Schleife nichts kostet und nichts Neues prüft.
DNS-Änderungen brauchen Zeit, bis sie jeden Resolver erreichen. Ein vor einer Minute veröffentlichter Eintrag kann hier als missing und etwas später als found erscheinen, eine fehlgeschlagene Prüfung ist also kein Grund, einen korrekten Eintrag zu ändern.
