Domini certificati

L’endpoint Domini consente di attivare e gestire domini certificati per la posta elettronica certificata tramite API. Questo servizio è pensato per tutte le piattaforme che vogliono offrire PEC con dominio personalizzato, automatizzando completamente il processo di configurazione e gestione.

Integrando l’API Domini è possibile creare domini certificati, associarli ai propri servizi e gestire in modo scalabile più domini per clienti diversi, senza interventi manuali.

Domini certificati PEC

Un dominio certificato permette di creare caselle PEC personalizzate (es. [email protected]), offrendo maggiore controllo, branding e flessibilità rispetto ai domini standard.

Una volta completata la certificazione, il dominio potrà essere utilizzato per creare nuove caselle PEC personalizzate, consentendo di offrire un servizio completamente brandizzato e sotto il proprio controllo.

Prima di richiedere la certificazione del dominio, è necessario effettuare alcune configurazioni tecniche per dimostrarne il possesso o il controllo. In particolare, il dominio dovrà essere correttamente configurato lato DNS e risultare coerente con i dati di registrazione (WHOIS o configurazioni equivalenti).

Queste operazioni devono essere effettuate preventivamente dall’utente, in quanto rappresentano un requisito fondamentale per poter avviare il processo di certificazione e garantire la corretta attivazione del dominio.

Il servizio utilizza un processo asincrono: una volta inviata la richiesta di attivazione, il dominio viene configurato e reso disponibile entro 24 ore.

Il servizio permette di:

Questo endpoint è particolarmente utile per software house, system integrator e piattaforme che vogliono offrire servizi PEC personalizzati ai propri clienti.

Attivazione dominio certificato

L’endpoint POST/domini consente di attivare un dominio certificato.

ESEMPIO RICHIESTA

POST/domini

Questo è un esempio di chiamata per attivare un dominio certificato:

POST https://pec.openapi.it/domini

Nel body della richiesta dovranno essere inclusi i dati del dominio e del titolare:

Questo è un esempio di payload:

{
  "dominio": "tuodominio.it",
  "ragione_sociale": "Azienda Srl",
  "partita_iva": "12345678901",
  "email": "[email protected]",
  "telefono": "0212345678",
  "indirizzo": "Via Roma 1",
  "comune": "Milano",
  "cap": "20100",
  "nazione": "IT"
}

Una volta inviata la richiesta, il dominio viene preso in carico e attivato entro 24 ore.

ESEMPIO RISPOSTA

POST/domini

La risposta contiene le informazioni relative al dominio e al suo stato:

{
  "data": {
    "dominio": "tuodominio.it",
    "stato": "in_attivazione",
    "timestamp": {
      "richiesta": 1710000000
    },
    "id": "abc123xyz"
  },
  "success": true,
  "message": "",
  "error": null
}

Verifica stato dominio certificato

È possibile verificare lo stato del dominio in qualsiasi momento tramite l’endpoint GET/domini/{id}.

ESEMPIO RICHIESTA

GET/domini/{id}

La chiamata per verificare lo stato del dominio con id abc123xyz sarà:

GET https://pec.openapi.it/domini/abc123xyz

ESEMPIO RISPOSTA

GET/domini/{id}

Questo è un esempio di risposta:

{
  "data": {
    "dominio": "tuodominio.it",
    "stato": "attivo",
    "timestamp": {
      "attivazione": 1710003600
    },
    "id": "abc123xyz"
  },
  "success": true,
  "message": "",
  "error": null
}

Una volta attivo, il dominio potrà essere utilizzato per la creazione e gestione di caselle PEC personalizzate.

A chi è rivolto

Il servizio Domini Certificati è pensato per tutte le realtà che vogliono offrire PEC con dominio personalizzato o gestire domini certificati in modo scalabile e automatizzato.

È particolarmente indicato per software house e system integrator che sviluppano piattaforme gestionali o soluzioni SaaS, dove è necessario attivare e gestire domini per più clienti in modo centralizzato e senza interventi manuali.

Allo stesso tempo, è uno strumento strategico per provider e rivenditori di servizi PEC, che possono offrire ai propri clienti caselle certificate con dominio personalizzato, aumentando il valore del servizio e il livello di branding.

Il servizio è adatto anche ad aziende strutturate e organizzazioni che desiderano gestire internamente i propri domini certificati, mantenendo il controllo completo sulle comunicazioni PEC e sui processi associati.