Verifica del contatto e reinvio tramite API

In conformità con le normative ICANN, la verifica delle informazioni di contatto del dominio è obbligatoria. Puoi gestire questi processi in modo efficiente direttamente tramite i nostri servizi API, senza accedere al pannello di controllo.

1. Query dello stato di verifica del dominio

Per controllare lo stato di verifica, il periodo di validità e la cronologia delle notifiche di un indirizzo e-mail, devi utilizzare il metodo GetDetails sotto ContactApi.svc.

Dettagli tecnici chiave:

• Periodo di validità: La chiave di verifica rimane valida per 60 giorni.
• Ambito: Questo metodo restituisce le informazioni di contatto pertinenti, lo stato di verifica attuale e la data dell’ultima notifica inviata.

Riferimenti tecnici:

Puoi fare riferimento ai seguenti elenchi aggiornati per la struttura del modello e i codici di stato da utilizzare durante la richiesta:

• Modello informazioni di verifica: https://paste.ubuntu.com/p/HDyrdRvh2D/

Stati di verifica

I principali codici di stato che riceverai come risultato della richiesta sono i seguenti:

2. Reinvio dell’e-mail di verifica tramite API

Puoi inviare immediatamente l’e-mail di verifica al proprietario del dominio tramite API. A questo scopo viene utilizzato il metodo ResendContactVerificationNotice sotto ContactApi.svc.

Questo metodo accetta due parametri opzionali differenti:

• E-mail del contatto: Puoi inserire direttamente l’indirizzo e-mail del cliente. Il sistema elabora la richiesta utilizzando questo indirizzo.
• ID esterno: Puoi fornire l’ID handle del contatto associato al dominio (ad esempio DNA-111). Il sistema recupera dal database le informazioni e-mail collegate a questo ID e reinvia la notifica se l’e-mail non è ancora stata verificata.

Nota: L’e-mail di notifica viene consegnata immediatamente senza essere messa in coda non appena viene attivata.

Modello dati di esempio

La struttura dei dati restituita al termine del processo è la seguente:

{
  "VerificationStatus": "NotValidated",
  "ExpirationDate": "2026-04-05T10:00:00",
  "LastNotificationDate": "2026-02-05T09:30:00",
  "ContactEmail": "example@customer.com"
}