EN 18222: kallene en backupleverandør tilbyr
Hvilke EN 18222-kall må en backupleverandør tilby? Etter punkt 4.1 er tre lesekall et krav: ReadDPPById, ReadDPPByProductId og ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById og ReadDPPVersionByIdAndDate anbefales. dpp-backup.com tilbyr alle unntatt ReadDataElement.
EN 18222:2026, Digitalt produktpass – programmeringsgrensesnitt (API-er) for livssyklusforvaltning og søkbarhet for produktpasset, beskriver kallene i et passgrensesnitt i abstrakte termer (punkt 4) og knytter dem til HTTPS-stier (punkt 8). Kommisjonens gjennomføringsbeslutning (EU) 2026/1736 viser til den som harmonisert standard etter ESPR. Denne siden oppsummerer standarden med våre egne ord; den gjengir ikke teksten.
Hva punkt 4.1 krever av en backupleverandør
| Kall | EN 18222 4.1 | dpp-backup.com |
|---|---|---|
| ReadDPPById (4.2) | Skal tilbys | Tilbys |
| ReadDPPByProductId (4.3) | Skal tilbys | Tilbys |
| ReadDPPIdsByProductIds (4.5) | Skal tilbys | Tilbys |
| ReadDataElement (6.2) | Bør tilbys | Tilbys ikke |
| CreateDPP (4.6) | Bør tilbys | Tilbys |
| DeleteDPPById (4.8) | Bør tilbys | Svarer, og avviser alltid med 405: en sikkerhetskopi oppbevares i hele passets levetid |
| ReadDPPVersionByIdAndDate (4.4) | Bør tilbys | Tilbys |
| UpdateDPPById (4.7) | Kreves av den som opprettet passet, eller hovedleverandøren når tredjeparter kan oppdatere passet | Tilbys, slik at plattformen din kan sende hver endring |
«Shall» (skal) er et krav i standarden. «Should» (bør) er en anbefaling.
Kallene i korte trekk
- ReadDPPById returnerer passet med en kjent pass-ID.
- ReadDPPByProductId returnerer det gjeldende aktive passet, den nyeste versjonen, for en unik produktidentifikator som i EN 18219.
- ReadDPPVersionByIdAndDate returnerer den versjonen av et pass som gjelder på en gitt dato og et gitt klokkeslett, i UTC, skrevet som i ISO 8601-1.
- ReadDPPIdsByProductIds returnerer pass-ID-ene som passer til et sett produktidentifikatorer.
- CreateDPP oppretter et pass og returnerer ID-en.
- UpdateDPPById sender bare delene som endres. Hvis én del feiler, feiler hele oppdateringen, og ingenting endres. Hver endring arkiveres slik EN 18221 krever.
- DeleteDPPById fjerner et pass ved slutten av levetiden, hvis tilgangsreglene tillater det.
For hvert kall avgjør tilgangsreglene hvilke dataelementer som returneres, og om en endring er tillatt.
HTTPS-stiene (punkt 8.2)
| Kall | Metode og sti |
|---|---|
| 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} |
Punkt 8.1 legger til at en id i en sti bør prosentkodes, og at RFC 7396 (JSON merge patch) kan brukes til oppdateringer. Punkt 4.1 anbefaler innholdsforhandling som i EN 18216 når et kall kan svare i mer enn ett format.
Feil (punkt 7.2)
Et kall som feiler, bør returnere et resultatobjekt med én eller flere meldinger. Hver melding har en type (Info, Warning, Error eller Exception), en tekst, og kan ha en kode og et tidspunkt. Tabell 15 knytter statuskodene til HTTP: for eksempel 400 for en ugyldig forespørsel, 401 for manglende legitimasjon, 404 for ikke funnet, 405 for en metode som ikke er tillatt, og 409 for en ressurs som allerede finnes.
Hvordan dpp-backup.com bruker den
- Plattformen din sender med CreateDPP og UpdateDPPById, på stiene i punkt 8.2 under
https://dpp-backup.com/api/v1. - Oppdateringer er JSON merge patches. Hvis det flettede passet ikke er gyldig, lagres ingenting.
- Et avvist kall får resultatobjektet i punkt 7.2.
- De fire lesekallene svarer fra kopien, på et domene som er åpnet for lesing.
Ta vare på en sikkerhetskopi av passene dine
Opprett en organisasjon med jobb-e-posten din. Når den er godkjent, kobler du til plattformen som har passene dine.
Du må bruke en jobb-e-postadresse. Våre medarbeidere går gjennom nye organisasjoner på virkedager. Portalen er på engelsk.