Domaines certifiés

L’endpoint Domains permet d’activer et de gérer des domaines certifiés pour le courrier électronique certifié via API. Ce service est conçu pour les plateformes souhaitant proposer des boîtes PEC avec un domaine personnalisé, en automatisant entièrement le processus de configuration et de gestion.

En intégrant l’API Domains, il est possible de créer des domaines certifiés, de les associer à ses services et de gérer plusieurs domaines pour différents clients de manière évolutive, sans intervention manuelle.

Domaines PEC certifiés

Un domaine certifié permet de créer des boîtes PEC personnalisées (ex. [email protected]), offrant plus de contrôle, de branding et de flexibilité par rapport aux domaines standards.

Une fois le processus de certification terminé, le domaine peut être utilisé pour créer de nouvelles boîtes PEC personnalisées, permettant de proposer un service entièrement brandé et sous votre contrôle.

Avant de demander la certification du domaine, certaines configurations techniques doivent être effectuées afin de prouver la propriété ou le contrôle du domaine. En particulier, le domaine doit être correctement configuré au niveau DNS et être cohérent avec les données d’enregistrement (WHOIS ou configurations équivalentes).

Ces opérations doivent être effectuées au préalable par l’utilisateur, car elles constituent une condition essentielle pour lancer le processus de certification et garantir l’activation correcte du domaine.

Le service utilise un processus asynchrone : une fois la demande d’activation envoyée, le domaine est configuré et rendu disponible dans un délai de 24 heures.

Le service permet de :

Cet endpoint est particulièrement utile pour les éditeurs de logiciels, les intégrateurs systèmes et les plateformes souhaitant proposer des services PEC personnalisés à leurs clients.

Activation d’un domaine certifié

L’endpoint POST/domini permet d’activer un domaine certifié.

EXEMPLE DE REQUÊTE

POST/domini

Voici un exemple de requête pour activer un domaine certifié :

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

Le corps de la requête doit inclure les informations du domaine et du titulaire :

Voici un exemple de 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"
}

Une fois la requête envoyée, le domaine est pris en charge et activé dans un délai de 24 heures.

EXEMPLE DE RÉPONSE

POST/domini

La réponse contient les informations relatives au domaine et à son statut :

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

Vérification de l’état du domaine certifié

Il est possible de vérifier l’état du domaine à tout moment via l’endpoint GET/domini/{id}.

EXEMPLE DE REQUÊTE

GET/domini/{id}

La requête pour vérifier l’état du domaine avec l’id abc123xyz sera :

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

EXEMPLE DE RÉPONSE

GET/domini/{id}

Voici un exemple de réponse :

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

Une fois actif, le domaine peut être utilisé pour créer et gérer des boîtes PEC personnalisées.

À qui s’adresse ce service

Le service Domaines Certifiés est conçu pour les organisations souhaitant proposer des boîtes PEC avec un domaine personnalisé ou gérer des domaines certifiés de manière évolutive et automatisée.

Il est particulièrement adapté aux éditeurs de logiciels et aux intégrateurs systèmes développant des plateformes de gestion ou des solutions SaaS, où il est nécessaire d’activer et de gérer des domaines pour plusieurs clients de manière centralisée et sans intervention manuelle.

Il constitue également un outil stratégique pour les fournisseurs et revendeurs de services PEC, qui peuvent proposer à leurs clients des boîtes certifiées avec un domaine personnalisé, augmentant ainsi la valeur du service et le niveau de branding.

Le service convient également aux entreprises structurées et aux organisations souhaitant gérer en interne leurs domaines certifiés, en conservant un contrôle total sur les communications PEC et les processus associés.