Activer et gérer Legalmail PEC et Digital Domicile via API
Sur Openapi, vous pouvez activer, renouveler, étendre votre espace de messagerie InfoCert Legalmail et Digital Domicile.
Vous pouvez vérifier si un domaine est certifié, c'est-à-dire apte à envoyer et recevoir des email certifiés, via l'endpoint GET /domini_pec/{dominio}.
Pour effectuer une demande au endpoint GET /domini_pec/{dominio}, vous devez transmettre le domaine de l'email certifié dans le corps de la demande en tant que valeur.
Avant de procéder à une demande d'activation, il est nécessaire de vérifier la disponibilité d'une adresse d'email certifié via la méthode GET /verifica_pec/{pec}.
Pour effectuer une demande au endpoint GET /verifica_pec/{pec} et vérifier ainsi la disponibilité d'une adresse d'email certifié, il est nécessaire de transmettre l'adresse complète de l'email certifié dans le corps de la demande en tant que valeur, par exemple: [email protected].
Actuellement, il n'est possible de vérifier la disponibilité que des les email certifiés Legalmail et Digital Domicile.
Vous pouvez consulter la liste complète des email certifiés enregistrés via le compte Openapi avec l'endpoint GET /pec.
Aucun paramètre ou valeur n'est nécessaire dans le corps de la requête.
La réponse à la demande indiquera des informations telles que l'adresse d'email certifiés, le type de boîte, le statut, la date d'expiration, l'enregistrement.
Vous pouvez enregistrer les types de boîtes d'email certifiés suivants:
- 'box_name'@legalmail.it (par exemple [email protected]) pour les boîtes STANDARD, BRONZE, SILVER ET GOLD ;
- 'box_name'@domiciliodigitale.com (par exemple [email protected]) pour la boîte DOMICILIODIGITALE ;
- 'box_name'@pecmassive.com (E.g. [email protected]) pour la boîte PECMASSIVA.
Il est possible d'enregistrer une adresse d'email certifié via l'endpoint POST /pec.
Veuillez noter que l'enregistrement ne prévoit pas automatiquement l'activation de la boîte PEC, qui doit être réalisée en envoyant la documentation nécessaire via l'endpoint PATCH /pec/{id}/activation. L'identifiant est présent dans la réponse à la requête POST /pec .
Pour compléter l'activation d'un CEP, il est nécessaire d'envoyer via la méthode PATCH /pec/{id}/attivazione:
- une pièce d'identité valide
- le formulaire d'activation complété et signé
Pour les cases de type DOMICILIODIGITALE et PECMASSIVA, il est nécessaire de créer un document unique composé du formulaire d'activation signé et de la pièce d'identité.
Les documents doivent être au format PDF.
Le formulaire d'activation est disponible via la méthode GET/pec/{id}/modulo_attivazione.
Le formulaire d'activation est disponible en utilisant la méthode GET/pec/{id}/modulo_attivazione.
L'identifiant est présent dans la réponse à la requête POST /pec .
Le statut d'une boîte d'email certifié peut être:
- registrata (enregistré)
- in_attivazione (en_activation)
- evasa (évadé)
- revocata (révoqué)
- chiusa (fermée)
Le statut "registrata" ("enregistré") signifie que l'adresse de l'email certifié a été enregistrée via l'endpoint POST /pec, mais que la documentation nécessaire (documents et formulaire d'activation complété et signé) doit être envoyée pour activer la boîte. Pour envoyer la documentation, la méthode GET/pec/{id}/modulo_attivazione doit être utilisée. Une fois la demande terminée, le statut passera à "in_attivazione" ("en_activation").
Une fois la documentation envoyée, elle sera vérifiée et, dans quelques heures, le statut de l'email certifié passera à "evasa" ("évadé") et la boîte sera utilisable.
Il est possible à tout moment de vérifier le statut d'une email certifié via la méthode GET /pec/{id}.
Le statut "revocata" ("révoqué") peut signifier que l'adresse de l'email certifié n'a pas été renouvelée ou que la révocation a été demandée via la méthode dédiée (DELETE /pec/{id}).
Oui, il est possible de modifier les caractéristiques de l'email certifié, pour l'instant uniquement pour les boîtes Legalmail.
Vous pouvez notamment:
- augmenter la taille de l'inbox (méthode PATCH /pec/{id}/modifica)
- augmenter la taille de l'archive de sécurité (PATCH /pec/{id}/modifica)
- activer la conservation (PATCH /pec/{id}/conservazione)
- passer d'un type de boîte à un autre, par exemple de bronze à silver (PATCH /pec/{id}/transformazione).
Vous pouvez renouveler un'e-mail certifié pour une ou plusieurs années via l'endpoint GET /pec/{id}/renewal.
Dans la demande de renouvellement, vous devrez transmettre l'identifiant associé à l'enregistrement/activation.
L'endpoint GET /pec vous permet d'obtenir les données, y compris l'ID, de tous les e-mail certifiés activés.