EN 18222: de kald, en backupudbyder tilbyder

Hvilke EN 18222-kald skal en backupudbyder tilbyde? Ifølge afsnit 4.1 er tre læsekald et krav: ReadDPPById, ReadDPPByProductId og ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById og ReadDPPVersionByIdAndDate anbefales. dpp-backup.com tilbyder dem alle undtagen ReadDataElement.

EN 18222:2026, Digitalt produktpas – Programmeringsgrænseflader (API’er) til livscyklusstyring og søgbarhed for produktpasset, beskriver kaldene i en pasgrænseflade i abstrakte termer (afsnit 4) og knytter dem til HTTPS-stier (afsnit 8). Kommissionens gennemførelsesafgørelse (EU) 2026/1736 henviser til den som harmoniseret standard under ESPR. Denne side opsummerer standarden med vores egne ord; den gengiver ikke dens tekst.

Hvad afsnit 4.1 kræver af en backupudbyder

KaldEN 18222 4.1dpp-backup.com
ReadDPPById (4.2)Skal tilbydesTilbydes
ReadDPPByProductId (4.3)Skal tilbydesTilbydes
ReadDPPIdsByProductIds (4.5)Skal tilbydesTilbydes
ReadDataElement (6.2)Bør tilbydesTilbydes ikke
CreateDPP (4.6)Bør tilbydesTilbydes
DeleteDPPById (4.8)Bør tilbydesSvarer og afviser altid med 405: en sikkerhedskopi opbevares i hele passets levetid
ReadDPPVersionByIdAndDate (4.4)Bør tilbydesTilbydes
UpdateDPPById (4.7)Kræves af den, der har oprettet passet, eller dennes hovedudbyder, når tredjeparter må opdatere passetTilbydes, så din platform kan sende hver ændring

»Skal« (shall) er et krav i standarden. »Bør« (should) er en anbefaling.

Kaldene i korte træk

  • ReadDPPById returnerer passet med et kendt pas-id.
  • ReadDPPByProductId returnerer det aktuelle aktive pas, den seneste version, for en unik produktidentifikator som i EN 18219.
  • ReadDPPVersionByIdAndDate returnerer den version af et pas, der gælder på en given dato og et givet tidspunkt, i UTC, skrevet som i ISO 8601-1.
  • ReadDPPIdsByProductIds returnerer de pas-id'er, der passer til et sæt produktidentifikatorer.
  • CreateDPP opretter et pas og returnerer dets id.
  • UpdateDPPById sender kun de dele, der ændres. Hvis én del fejler, fejler hele opdateringen, og intet ændres. Hver ændring arkiveres, som EN 18221 kræver.
  • DeleteDPPById fjerner et pas ved slutningen af dets levetid, hvis adgangsreglerne tillader det.

For hvert kald afgør adgangsreglerne, hvilke dataelementer der returneres, og om en ændring er tilladt.

HTTPS-stierne (afsnit 8.2)

KaldMetode og sti
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}

Afsnit 8.1 tilføjer, at et id i en sti bør procentkodes, og at RFC 7396 (JSON merge patch) kan bruges til opdateringer. Afsnit 4.1 anbefaler indholdsforhandling som i EN 18216, når et kald kan svare i mere end ét format.

Fejl (afsnit 7.2)

Et mislykket kald bør returnere et resultatobjekt med en eller flere beskeder. Hver besked har en type (Info, Warning, Error eller Exception), en tekst og kan have en kode og et tidspunkt. Tabel 15 knytter statuskoderne til HTTP: f.eks. 400 for en ugyldig forespørgsel, 401 for manglende adgangsoplysninger, 404 for ikke fundet, 405 for en metode, der ikke er tilladt, og 409 for en ressource, der allerede findes.

Sådan bruger dpp-backup.com den

  • Din platform sender med CreateDPP og UpdateDPPById på stierne fra afsnit 8.2 under https://dpp-backup.com/api/v1.
  • Opdateringer er JSON merge patches. Hvis det flettede pas ikke er gyldigt, gemmes intet.
  • Et afvist kald får resultatobjektet fra afsnit 7.2.
  • De fire læsekald svarer fra kopien på et domæne, der er åbnet for læsning.

Dokumentation · EN 18221

Opbevar en sikkerhedskopi af dine pas

Opret en organisation med din e-mail fra virksomheden. Når den er godkendt, tilslutter du den platform, der har dine pas.

Der kræves en e-mailadresse fra virksomheden. Vores medarbejdere gennemgår nye organisationer på hverdage. Portalen er på engelsk.