Kontaktverifizierung und erneutes Versenden per API
Gemäß den ICANN-Vorschriften ist die Verifizierung der Domain-Kontaktdaten verpflichtend. Sie können diese Prozesse direkt über unsere API-Dienste effizient verwalten, ohne sich im Kontrollpanel anmelden zu müssen.
1. Abfrage des Domain-Verifizierungsstatus
Um den Verifizierungsstatus, die Gültigkeitsdauer und den Benachrichtigungsverlauf einer E-Mail-Adresse zu prüfen, müssen Sie die Methode GetDetails unter ContactApi.svc verwenden.
Wichtige technische Details:
- Gültigkeitsdauer: Der Verifizierungsschlüssel ist 60 Tage lang gültig.
- Umfang: Diese Methode liefert die relevanten Kontaktinformationen, den aktuellen Verifizierungsstatus sowie das Datum der zuletzt gesendeten Benachrichtigung.
Technische Referenzen:
Die folgenden aktuellen Listen zur Modellstruktur und zu den bei der Abfrage zu verwendenden Statuscodes können Sie hier einsehen:
- Verifizierungsinformationsmodell: https://paste.ubuntu.com/p/HDyrdRvh2D/
Verifizierungsstatus
Die wichtigsten Statuscodes, die Sie als Ergebnis der Abfrage erhalten, sind folgende:
| Status | Beschreibung |
| NotValidated | Der Verifizierungsprozess wurde noch nicht durchgeführt. |
| Validated | Die E-Mail-Adresse wurde erfolgreich verifiziert. |
| Pending | Der Verifizierungsprozess läuft / steht noch aus. |
| Expired | Der 60-Tage-Verifizierungsschlüssel ist abgelaufen. |
2. Erneutes Versenden der Verifizierungs-E-Mail per API
Sie können die Verifizierungs-E-Mail sofort über die API an den Domaininhaber senden. Zu diesem Zweck wird die Methode ResendContactVerificationNotice unter ContactApi.svc verwendet.
Diese Methode akzeptiert zwei verschiedene optionale Parameter:
- Kontakt-E-Mail: Sie können die E-Mail-Adresse des Kunden direkt eingeben. Das System verarbeitet die Anfrage anhand dieser Adresse.
- External ID: Sie können die mit der Domain verknüpfte Kontakt-Handle-ID angeben (z. B. DNA-111). Das System ruft die mit dieser ID verknüpften E-Mail-Informationen aus der Datenbank ab und sendet die Benachrichtigung erneut, falls die E-Mail-Adresse noch nicht verifiziert wurde.
Hinweis: Die Benachrichtigungs-E-Mail wird sofort zugestellt und nicht in eine Warteschlange gestellt, sobald sie ausgelöst wird.
Beispiel-Datenmodell
Die nach Abschluss des Vorgangs zurückgegebene Datenstruktur sieht wie folgt aus:
{
"VerificationStatus": "NotValidated",
"ExpirationDate": "2026-04-05T10:00:00",
"LastNotificationDate": "2026-02-05T09:30:00",
"ContactEmail": "example@customer.com"
}
