Aktivieren und verwalten Sie Legalmail PEC und Digital Domicile über API
Über Openapi können Sie Ihren InfoCert Legalmail- und Digital Domicile-Postfachplatz aktivieren, erneuern und erweitern
Sie können die folgenden Arten von zertifizierte E-Mails-Boxen registrieren:
- 'box_name'@legalmail.com (z.B. [email protected]) für STANDARD, BRONZE, SILVER und GOLD Boxen;
- 'box_name'@domiciliodigitale.com (z.B. [email protected]) für das Fach DOMICILIODIGITALE;
- 'box_name'@pecmassive.com (z. B. [email protected]) für die PECMASSIVA-Box.
Es ist möglich, eine zertifizierte E-Mail-Adresse über den Endpoint POST /pec zu registrieren.
Denken Sie daran, dass die Registrierung nicht automatisch die Aktivierung der zertifizierte E-Mail-Box zur Folge hat. Diese muss durch Übermittlung der erforderlichen Unterlagen über den PATCH-Endpoint erfolgen /pec/{id}/aktivierung. Die ID ist in der Antwort auf die POST-Anfrage /pec enthalten.
Um die Aktivierung eines zertifizierte E-Mails abzuschließen, müssen Sie über die PATCH-Methode /pec/{id}/aktivierung:
- gültiges Identitätsdokument
- ausgefülltes und unterzeichnetes Aktivierungsformular
Für die Felder des Typs DOMICILIODIGITALE und PECMASSIVA muss ein einziges Dokument erstellt werden, das aus dem unterzeichneten Aktivierungsformular und dem Identitätsdokument besteht.
Die Dokumente müssen im PDF-Format vorliegen.
Das Aktivierungsformular ist über die Methode GET/pec/{id}/modulo_attivazione verfügbar.
Das Aktivierungsformular ist über die Methode GET/pec/{id}/modulo_attivazione verfügbar.
Die ID ist in der Antwort auf die POST-Anforderung /pec enthalten.
Der Status einer zertifizierte E-Mails-Box kann sein:
- registrata (registriert)
- in_attivazione (in_Aktivierung)
- evasa (umgangen)
- revocata (widerrufen)
- chiusa (geschlossen)
Der Status "registrata" ("registriert") bedeutet, dass die zertifizierte E-Mails-Adresse über den Endpoint POST /pec registriert wurde, aber die erforderlichen Unterlagen (Dokumente und ausgefülltes und unterschriebenes Aktivierungsformular) gesendet werden müssen, um die Box zu aktivieren. Um die Unterlagen zu senden, muss die Methode GET/pec/{id}/modulo_attivazione verwendet werden. Nach Abschluss der Anfrage ändert sich der Status in "in_attivazione ("in_Aktivierung").
Nach der Übermittlung der Unterlagen werden diese überprüft, und innerhalb weniger Stunden ändert sich der Status des zertifizierte E-Mails auf "evasa" ("verarbeitet"), und das Feld kann benutzt werden.
Es ist jederzeit möglich, den Status einer zertifizierte E-Mails über die GET-Methode zu überprüfen /pec/{id}.
Der Status "revocata" ("widerrufen") kann bedeuten, dass die zertifizierte E-Mails-Adresse nicht verlängert wurde oder dass der Widerruf über die spezielle Methode (DELETE /pec/{id}) beantragt wurde.
Ja, es ist möglich, die Eigenschaften der zertifizierte E-Mails zu ändern, derzeit nur für Legalmail-Boxen.
Sie können insbesondere
- die Größe des Posteingangs erhöhen (PATCH-Methode /pec/{id}/modifica)
- die Größe des Sicherheitsarchivs erhöhen (PATCH /pec/{id}/modifica)
- die Aufbewahrung aktivieren (PATCH /pec/{id}/conservazione)
- Upgrade zwischen zwei Box-Typen, z. B. von Bronze auf Silver (PATCH /pec/{id}/transformazione)
Sie können ein CEM für ein oder mehrere Jahre über den GET-Endpoint /pec/{id}/renewal verlängern.
In der Verlängerungsanfrage müssen Sie die mit der Registrierung/Aktivierung verbundene ID angeben.
Über den GET-Endpoint /pec können Sie die Daten, einschließlich der ID, aller aktivierten CEMs abrufen.
Sie können über den GET-Endpoint /domini_pec/{dominio} prüfen, ob eine Domain zertifiziert ist, d.h. ob sie für das Senden und Empfangen von zertifizierte E-Mail geeignet ist.
Um eine Anfrage an den GET-Endpoint /domini_pec/{dominio} zu stellen, muss die Domäne des zertifizierte E-Mail als Wert im Hauptteil der Anfrage übergeben werden.
Bevor eine Aktivierungsanfrage gestellt wird, muss die Verfügbarkeit einer zertifizierte E-Mail-Adresse mit der Methode GET /verifica_pec/{pec} überprüft werden.
Um eine Anfrage an den GET-Endpoint /verifica_pec/{pec} zu stellen und damit die Verfügbarkeit einer zertifizierte E-Mail-Adresse zu prüfen, ist es notwendig, die vollständige Adresse des zertifizierte E-Mails im Body der Anfrage als Wert zu übergeben, z.B.: [email protected].
Derzeit ist es nur möglich, die Verfügbarkeit von Legalmail und Digital Domicile zertifizierte E-Mails zu prüfen.
Sie können die vollständige Liste der registrierten zertifizierte E-Mails über das Openapi-Konto mit dem Endpoint GET /pec überprüfen.
Im Hauptteil der Anfrage ist kein Parameter oder Wert erforderlich.
In der Antwort auf die Anfrage werden Informationen wie zertifizierte E-Mail-Adresse, Box-Typ, Status, Ablaufdatum und Registrierung angegeben.