EN 18222: die Aufrufe, die ein Sicherungsanbieter anbietet

Welche EN-18222-Aufrufe muss ein Sicherungsanbieter anbieten? Nach Abschnitt 4.1 sind drei Leseaufrufe Pflicht: ReadDPPById, ReadDPPByProductId und ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById und ReadDPPVersionByIdAndDate werden empfohlen. dpp-backup.com bietet sie alle an, außer ReadDataElement.

EN 18222:2026, Digital Product Passport – Application Programming Interfaces (APIs) for the product passport lifecycle management and searchability, beschreibt die Aufrufe einer Passschnittstelle abstrakt (Abschnitt 4) und bildet sie auf HTTPS-Pfade ab (Abschnitt 8). Der Durchführungsbeschluss (EU) 2026/1736 der Kommission führt sie als harmonisierte Norm nach der ESPR an. Diese Seite fasst die Norm in eigenen Worten zusammen; sie gibt ihren Text nicht wieder.

Was Abschnitt 4.1 von einem Sicherungsanbieter verlangt

AufrufEN 18222 4.1dpp-backup.com
ReadDPPById (4.2)Muss angeboten werdenAngeboten
ReadDPPByProductId (4.3)Muss angeboten werdenAngeboten
ReadDPPIdsByProductIds (4.5)Muss angeboten werdenAngeboten
ReadDataElement (6.2)Sollte angeboten werdenNicht angeboten
CreateDPP (4.6)Sollte angeboten werdenAngeboten
DeleteDPPById (4.8)Sollte angeboten werdenAntwortet und lehnt immer mit 405 ab: Eine Sicherungskopie wird für die Lebensdauer des Passes aufbewahrt
ReadDPPVersionByIdAndDate (4.4)Sollte angeboten werdenAngeboten
UpdateDPPById (4.7)Vom Ersteller oder seinem Hauptanbieter verlangt, wenn Dritte den Pass aktualisieren dürfenAngeboten, damit Ihre Plattform jede Änderung senden kann

„Shall“ (muss) ist eine Anforderung der Norm. „Should“ (sollte) ist eine Empfehlung.

Die Aufrufe im Überblick

  • ReadDPPById liefert den Pass mit einer bekannten Pass-ID.
  • ReadDPPByProductId liefert den aktuell aktiven Pass, die neueste Version, für eine eindeutige Produktkennung nach EN 18219.
  • ReadDPPVersionByIdAndDate liefert die Version eines Passes, die zu einem bestimmten Datum und einer bestimmten Uhrzeit gilt, in UTC, geschrieben nach ISO 8601-1.
  • ReadDPPIdsByProductIds liefert die Pass-IDs, die zu einer Menge von Produktkennungen passen.
  • CreateDPP legt einen Pass an und liefert seine ID.
  • UpdateDPPById sendet nur die Teile, die sich ändern. Schlägt ein Teil fehl, schlägt die gesamte Aktualisierung fehl, und nichts ändert sich. Jede Änderung wird archiviert, wie EN 18221 es verlangt.
  • DeleteDPPById entfernt einen Pass am Ende seiner Lebensdauer, wenn die Zugriffsregeln es erlauben.

Bei jedem Aufruf entscheiden Zugriffsregeln, welche Datenelemente zurückkommen und ob eine Änderung erlaubt ist.

Die HTTPS-Pfade (Abschnitt 8.2)

AufrufMethode und Pfad
ReadDPPByIdGET v1/dpps/{dppId}
ReadDPPByProductIdGET v1/dppsByProductId/{productId}
ReadDPPVersionByIdAndDateGET v1/dppsByIdAndDate/{dppId}?date={timestamp}
ReadDPPIdsByProductIdsPOST v1/dppsByProductIds
CreateDPPPOST v1/dpps
UpdateDPPByIdPATCH v1/dpps/{dppId}
DeleteDPPByIdDELETE v1/dpps/{dppId}

Abschnitt 8.1 ergänzt, dass eine ID in einem Pfad prozentkodiert sein sollte und dass RFC 7396 (JSON Merge Patch) für Aktualisierungen verwendet werden kann. Abschnitt 4.1 empfiehlt Content Negotiation nach EN 18216, wenn ein Aufruf in mehr als einem Format antworten kann.

Fehler (Abschnitt 7.2)

Ein fehlgeschlagener Aufruf sollte ein Ergebnisobjekt mit einer oder mehreren Meldungen liefern. Jede Meldung hat einen Typ (Info, Warning, Error oder Exception) und einen Text und kann einen Code und einen Zeitpunkt haben. Tabelle 15 bildet die Statuscodes auf HTTP ab: zum Beispiel 400 für eine fehlerhafte Anfrage, 401 für fehlende Zugangsdaten, 404 für nicht gefunden, 405 für eine nicht erlaubte Methode und 409 für eine bereits vorhandene Ressource.

Wie dpp-backup.com sie nutzt

  • Ihre Plattform sendet mit CreateDPP und UpdateDPPById, auf den Pfaden aus Abschnitt 8.2 unter https://dpp-backup.com/api/v1.
  • Aktualisierungen sind JSON Merge Patches. Ist der zusammengeführte Pass nicht gültig, wird nichts gespeichert.
  • Ein abgewiesener Aufruf erhält das Ergebnisobjekt aus Abschnitt 7.2.
  • Die vier Leseaufrufe antworten aus der Kopie, auf einer Domain, die zum Lesen geöffnet ist.

Dokumentation · EN 18221

Halten Sie eine Sicherungskopie Ihrer Pässe bereit

Legen Sie mit Ihrer geschäftlichen E-Mail-Adresse eine Organisation an. Nach der Freigabe verbinden Sie die Plattform, die Ihre Pässe hält.

Eine geschäftliche E-Mail-Adresse ist erforderlich. Unsere Mitarbeiter prüfen neue Organisationen an Werktagen. Das Portal ist auf Englisch.