EN 18222: de anrop som en leverantör av säkerhetskopior erbjuder
Vilka anrop i EN 18222 måste en leverantör av säkerhetskopior erbjuda? Enligt avsnitt 4.1 är tre läsanrop ett krav: ReadDPPById, ReadDPPByProductId och ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById och ReadDPPVersionByIdAndDate rekommenderas. dpp-backup.com erbjuder alla utom ReadDataElement.
EN 18222:2026, Digital Product Passport – Application Programming Interfaces (APIs) for the product passport lifecycle management and searchability, beskriver anropen i ett passgränssnitt i abstrakta termer (avsnitt 4) och kopplar dem till HTTPS-sökvägar (avsnitt 8). Kommissionens genomförandebeslut (EU) 2026/1736 hänvisar till den som en harmoniserad standard enligt ESPR. Den här sidan sammanfattar standarden med våra egna ord; den återger inte dess text.
Vad avsnitt 4.1 kräver av en leverantör av säkerhetskopior
| Anrop | EN 18222 4.1 | dpp-backup.com |
|---|---|---|
| ReadDPPById (4.2) | Ska erbjudas | Erbjuds |
| ReadDPPByProductId (4.3) | Ska erbjudas | Erbjuds |
| ReadDPPIdsByProductIds (4.5) | Ska erbjudas | Erbjuds |
| ReadDataElement (6.2) | Bör erbjudas | Erbjuds inte |
| CreateDPP (4.6) | Bör erbjudas | Erbjuds |
| DeleteDPPById (4.8) | Bör erbjudas | Svarar, och avvisar alltid med 405: en säkerhetskopia sparas under passets hela livslängd |
| ReadDPPVersionByIdAndDate (4.4) | Bör erbjudas | Erbjuds |
| UpdateDPPById (4.7) | Krävs av den som skapade passet eller dess huvudleverantör när tredje parter får uppdatera passet | Erbjuds, så att din plattform kan skicka varje ändring |
”Shall” (ska) är ett krav i standarden. ”Should” (bör) är en rekommendation.
Anropen i korthet
- ReadDPPById returnerar passet med ett känt pass-id.
- ReadDPPByProductId returnerar det aktuella aktiva passet, den senaste versionen, för en unik produktbeteckning enligt EN 18219.
- ReadDPPVersionByIdAndDate returnerar den version av ett pass som gäller vid ett visst datum och klockslag, i UTC, skrivet enligt ISO 8601-1.
- ReadDPPIdsByProductIds returnerar de pass-id:n som matchar en uppsättning produktbeteckningar.
- CreateDPP skapar ett pass och returnerar dess id.
- UpdateDPPById skickar bara de delar som ändras. Om en del misslyckas misslyckas hela uppdateringen och ingenting ändras. Varje ändring arkiveras som EN 18221 kräver.
- DeleteDPPById tar bort ett pass, i slutet av dess livslängd, om åtkomstreglerna tillåter det.
För varje anrop avgör åtkomstreglerna vilka dataelement som returneras och om en ändring är tillåten.
HTTPS-sökvägarna (avsnitt 8.2)
| Anrop | Metod och sökväg |
|---|---|
| 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} |
Avsnitt 8.1 tillägger att ett id i en sökväg bör procentkodas och att RFC 7396 (JSON merge patch) kan användas för uppdateringar. Avsnitt 4.1 rekommenderar innehållsförhandling enligt EN 18216 när ett anrop kan svara i mer än ett format.
Fel (avsnitt 7.2)
Ett misslyckat anrop bör returnera ett resultatobjekt med ett eller flera meddelanden. Varje meddelande har en typ (Info, Warning, Error eller Exception), en text och kan ha en kod och en tidpunkt. Tabell 15 kopplar statuskoderna till HTTP: till exempel 400 för en felaktig begäran, 401 för saknade inloggningsuppgifter, 404 för hittades inte, 405 för en metod som inte är tillåten och 409 för en resurs som redan finns.
Så använder dpp-backup.com den
- Din plattform skickar med CreateDPP och UpdateDPPById, på sökvägarna i avsnitt 8.2 under
https://dpp-backup.com/api/v1. - Uppdateringar är JSON merge patches. Om det sammanslagna passet inte är giltigt lagras ingenting.
- Ett avvisat anrop får resultatobjektet i avsnitt 7.2.
- De fyra läsanropen svarar från kopian, på en domän som är öppen för läsning.