Zertifizierte Domains

Der Domains-Endpunkt ermöglicht es, zertifizierte Domains für zertifizierte E-Mail (PEC) über API zu aktivieren und zu verwalten. Dieser Service richtet sich an Plattformen, die PEC-Postfächer mit einer benutzerdefinierten Domain anbieten möchten und dabei den gesamten Konfigurations- und Verwaltungsprozess vollständig automatisieren.

Durch die Integration der Domains API können zertifizierte Domains erstellt, den eigenen Services zugeordnet und mehrere Domains für unterschiedliche Kunden skalierbar und ohne manuelle Eingriffe verwaltet werden.

Zertifizierte PEC-Domains

Eine zertifizierte Domain ermöglicht die Erstellung individueller PEC-Postfächer (z. B. [email protected]) und bietet im Vergleich zu Standard-Domains mehr Kontrolle, Branding und Flexibilität.

Nach Abschluss des Zertifizierungsprozesses kann die Domain zur Erstellung neuer individueller PEC-Postfächer verwendet werden, sodass ein vollständig gebrandeter Service unter eigener Kontrolle angeboten werden kann.

Vor der Beantragung der Domain-Zertifizierung müssen einige technische Konfigurationen durchgeführt werden, um den Besitz oder die Kontrolle der Domain nachzuweisen. Insbesondere muss die Domain auf DNS-Ebene korrekt konfiguriert sein und mit den Registrierungsdaten (WHOIS oder gleichwertige Konfigurationen) übereinstimmen.

Diese Schritte müssen im Voraus vom Nutzer durchgeführt werden, da sie eine grundlegende Voraussetzung darstellen, um den Zertifizierungsprozess zu starten und die korrekte Aktivierung der Domain sicherzustellen.

Der Service verwendet einen asynchronen Prozess: Nach dem Absenden der Aktivierungsanfrage wird die Domain innerhalb von 24 Stunden konfiguriert und verfügbar gemacht.

Der Service ermöglicht es:

Dieser Endpunkt ist besonders nützlich für Softwarehäuser, Systemintegratoren und Plattformen, die ihren Kunden individuelle PEC-Services anbieten möchten.

Aktivierung einer zertifizierten Domain

Der Endpunkt POST/domini ermöglicht die Aktivierung einer zertifizierten Domain.

ANFRAGEBEISPIEL

POST/domini

Dies ist ein Beispiel für eine Anfrage zur Aktivierung einer zertifizierten Domain:

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

Im Request-Body müssen die Domain- und Inhaberdaten enthalten sein:

Dies ist ein Beispiel für ein 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"
}

Nach dem Absenden der Anfrage wird die Domain verarbeitet und innerhalb von 24 Stunden aktiviert.

ANTWORTBEISPIEL

POST/domini

Die Antwort enthält Informationen zur Domain und zu ihrem Status:

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

Überprüfung des Status der zertifizierten Domain

Der Status der Domain kann jederzeit über den Endpunkt GET/domini/{id} überprüft werden.

ANFRAGEBEISPIEL

GET/domini/{id}

Die Anfrage zur Überprüfung des Domainstatus mit der ID abc123xyz lautet:

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

ANTWORTBEISPIEL

GET/domini/{id}

Dies ist ein Beispiel für eine Antwort:

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

Sobald die Domain aktiv ist, kann sie zur Erstellung und Verwaltung individueller PEC-Postfächer verwendet werden.

Für wen ist der Service geeignet

Der Service „Zertifizierte Domains“ richtet sich an Organisationen, die PEC-Postfächer mit benutzerdefinierter Domain anbieten oder zertifizierte Domains skalierbar und automatisiert verwalten möchten.

Er ist besonders geeignet für Softwarehäuser und Systemintegratoren, die Managementplattformen oder SaaS-Lösungen entwickeln, bei denen Domains für mehrere Kunden zentral und ohne manuelle Eingriffe aktiviert und verwaltet werden müssen.

Gleichzeitig ist er ein strategisches Werkzeug für Anbieter und Wiederverkäufer von PEC-Diensten, die ihren Kunden zertifizierte Postfächer mit individueller Domain anbieten und so den Servicewert und das Branding erhöhen können.

Der Service eignet sich auch für strukturierte Unternehmen und Organisationen, die ihre zertifizierten Domains intern verwalten möchten und dabei die volle Kontrolle über PEC-Kommunikation und zugehörige Prozesse behalten wollen.