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

KallEN 18222 4.1dpp-backup.com
ReadDPPById (4.2)Skal tilbysTilbys
ReadDPPByProductId (4.3)Skal tilbysTilbys
ReadDPPIdsByProductIds (4.5)Skal tilbysTilbys
ReadDataElement (6.2)Bør tilbysTilbys ikke
CreateDPP (4.6)Bør tilbysTilbys
DeleteDPPById (4.8)Bør tilbysSvarer, og avviser alltid med 405: en sikkerhetskopi oppbevares i hele passets levetid
ReadDPPVersionByIdAndDate (4.4)Bør tilbysTilbys
UpdateDPPById (4.7)Kreves av den som opprettet passet, eller hovedleverandøren når tredjeparter kan oppdatere passetTilbys, 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)

KallMetode 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}

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.

Dokumentasjon · EN 18221

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.