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

AnropEN 18222 4.1dpp-backup.com
ReadDPPById (4.2)Ska erbjudasErbjuds
ReadDPPByProductId (4.3)Ska erbjudasErbjuds
ReadDPPIdsByProductIds (4.5)Ska erbjudasErbjuds
ReadDataElement (6.2)Bör erbjudasErbjuds inte
CreateDPP (4.6)Bör erbjudasErbjuds
DeleteDPPById (4.8)Bör erbjudasSvarar, och avvisar alltid med 405: en säkerhetskopia sparas under passets hela livslängd
ReadDPPVersionByIdAndDate (4.4)Bör erbjudasErbjuds
UpdateDPPById (4.7)Krävs av den som skapade passet eller dess huvudleverantör när tredje parter får uppdatera passetErbjuds, 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)

AnropMetod och sökväg
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}

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.

Dokumentation · EN 18221

Ha en säkerhetskopia av dina pass

Skapa en organisation med din e-postadress på företaget. När den är godkänd ansluter du plattformen som har dina pass.

Du behöver en e-postadress på företaget. Vår personal granskar nya organisationer på vardagar. Portalen är på engelska.