EN 18222: de aanroepen die een back-upaanbieder biedt
Welke EN 18222-aanroepen moet een back-upaanbieder bieden? Volgens clausule 4.1 zijn drie leesaanroepen verplicht: ReadDPPById, ReadDPPByProductId en ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById en ReadDPPVersionByIdAndDate worden aanbevolen. dpp-backup.com biedt ze allemaal behalve ReadDataElement.
EN 18222:2026, Digital Product Passport – Application Programming Interfaces (APIs) for the product passport lifecycle management and searchability, beschrijft de aanroepen van een paspoortinterface in abstracte termen (clausule 4) en koppelt ze aan HTTPS-paden (clausule 8). Uitvoeringsbesluit (EU) 2026/1736 van de Commissie vermeldt de norm als geharmoniseerde norm op grond van de ESPR. Deze pagina vat de norm in onze eigen woorden samen; de tekst ervan wordt niet overgenomen.
Wat clausule 4.1 van een back-upaanbieder vraagt
| Aanroep | EN 18222 4.1 | dpp-backup.com |
|---|---|---|
| ReadDPPById (4.2) | Moet worden geboden | Geboden |
| ReadDPPByProductId (4.3) | Moet worden geboden | Geboden |
| ReadDPPIdsByProductIds (4.5) | Moet worden geboden | Geboden |
| ReadDataElement (6.2) | Zou moeten worden geboden | Niet geboden |
| CreateDPP (4.6) | Zou moeten worden geboden | Geboden |
| DeleteDPPById (4.8) | Zou moeten worden geboden | Antwoordt, en weigert altijd met 405: een back-upkopie wordt bewaard voor de hele levensduur van het paspoort |
| ReadDPPVersionByIdAndDate (4.4) | Zou moeten worden geboden | Geboden |
| UpdateDPPById (4.7) | Gevraagd van de opsteller of diens hoofdaanbieder wanneer derden het paspoort mogen bijwerken | Geboden, zodat uw platform elke wijziging kan versturen |
„Moet” (shall) is een eis van de norm. „Zou moeten” (should) is een aanbeveling.
De aanroepen in het kort
- ReadDPPById geeft het paspoort met een bekende paspoort-id terug.
- ReadDPPByProductId geeft het actuele actieve paspoort terug, de laatste versie, voor een unieke productidentificatiecode zoals in EN 18219.
- ReadDPPVersionByIdAndDate geeft de versie van een paspoort terug die geldt op een bepaalde datum en tijd, in UTC, geschreven zoals in ISO 8601-1.
- ReadDPPIdsByProductIds geeft de paspoort-id’s terug die bij een reeks productidentificatiecodes horen.
- CreateDPP maakt een paspoort aan en geeft de id ervan terug.
- UpdateDPPById verstuurt alleen de delen die veranderen. Als één deel mislukt, mislukt de hele update en verandert er niets. Elke wijziging wordt gearchiveerd zoals EN 18221 vraagt.
- DeleteDPPById verwijdert een paspoort, aan het einde van de levensduur, als de toegangsregels dat toestaan.
Bij elke aanroep bepalen toegangsregels welke gegevenselementen terugkomen en of een wijziging is toegestaan.
De HTTPS-paden (clausule 8.2)
| Aanroep | Methode en pad |
|---|---|
| ReadDPPById | GET v1/dpps/{dppId} |
| ReadDPPByProductId | GET v1/dppsByProductId/{productId} |
| ReadDPPVersionByIdAndDate | GET v1/dppsByIdAndDate/{dppId}?date={timestamp} |
| ReadDPPIdsByProductIds | POST v1/dppsByProductIds |
| CreateDPP | POST v1/dpps |
| UpdateDPPById | PATCH v1/dpps/{dppId} |
| DeleteDPPById | DELETE v1/dpps/{dppId} |
Clausule 8.1 voegt eraan toe dat een id in een pad met procentcodering zou moeten worden gecodeerd, en dat RFC 7396 (JSON merge patch) voor updates kan worden gebruikt. Clausule 4.1 beveelt contentonderhandeling zoals in EN 18216 aan wanneer een aanroep in meer dan één formaat kan antwoorden.
Fouten (clausule 7.2)
Een mislukte aanroep zou een resultaatobject met een of meer berichten moeten teruggeven. Elk bericht heeft een type (Info, Warning, Error of Exception), een tekst, en kan een code en een tijdstip hebben. Tabel 15 koppelt de statuscodes aan HTTP: bijvoorbeeld 400 voor een ongeldig verzoek, 401 voor ontbrekende inloggegevens, 404 voor niet gevonden, 405 voor een methode die niet is toegestaan en 409 voor een resource die al bestaat.
Hoe dpp-backup.com de norm gebruikt
- Uw platform verstuurt met CreateDPP en UpdateDPPById, op de paden van clausule 8.2 onder
https://dpp-backup.com/api/v1. - Updates zijn JSON merge patches. Als het samengevoegde paspoort niet geldig is, wordt er niets opgeslagen.
- Een geweigerde aanroep krijgt het resultaatobject van clausule 7.2.
- De vier leesaanroepen antwoorden vanuit de kopie, op een domein dat open is voor lezen.
Bewaar een back-upkopie van uw paspoorten
Maak een organisatie aan met uw zakelijke e-mailadres. Zodra die is goedgekeurd, koppelt u het platform dat uw paspoorten beheert.
Een zakelijk e-mailadres is vereist. Onze medewerkers beoordelen nieuwe organisaties op werkdagen. Het portaal is in het Engels.