EN 18222: kutsut, joita varmuuskopiopalvelun tarjoaja tarjoaa

Mitkä EN 18222 -kutsut varmuuskopiopalvelun tarjoajan on tarjottava? Kohdan 4.1 mukaan kolme lukukutsua on pakollisia: ReadDPPById, ReadDPPByProductId ja ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById ja ReadDPPVersionByIdAndDate ovat suositeltuja. dpp-backup.com tarjoaa ne kaikki paitsi ReadDataElement-kutsua.

EN 18222:2026, Digital Product Passport – Application Programming Interfaces (APIs) for the product passport lifecycle management and searchability, kuvaa passirajapinnan kutsut abstraktisti (kohta 4) ja yhdistää ne HTTPS-polkuihin (kohta 8). Komission täytäntöönpanopäätöksessä (EU) 2026/1736 siihen viitataan ESPR-asetuksen mukaisena yhdenmukaistettuna standardina. Tämä sivu tiivistää standardin omin sanoin; se ei toista sen tekstiä.

Mitä kohta 4.1 edellyttää varmuuskopiopalvelun tarjoajalta

KutsuEN 18222, kohta 4.1dpp-backup.com
ReadDPPById (4.2)On tarjottavaTarjolla
ReadDPPByProductId (4.3)On tarjottavaTarjolla
ReadDPPIdsByProductIds (4.5)On tarjottavaTarjolla
ReadDataElement (6.2)Pitäisi tarjotaEi tarjolla
CreateDPP (4.6)Pitäisi tarjotaTarjolla
DeleteDPPById (4.8)Pitäisi tarjotaVastaa ja hylkää aina koodilla 405: varmuuskopio säilytetään passin koko elinkaaren ajan
ReadDPPVersionByIdAndDate (4.4)Pitäisi tarjotaTarjolla
UpdateDPPById (4.7)Edellytetään laatijalta tai sen pääpalveluntarjoajalta, kun kolmannet osapuolet voivat päivittää passiaTarjolla, jotta alustasi voi lähettää jokaisen muutoksen

”Shall” on standardin vaatimus. ”Should” on suositus.

Kutsut lyhyesti

  • ReadDPPById palauttaa passin, jonka passitunniste tiedetään.
  • ReadDPPByProductId palauttaa nykyisen aktiivisen passin, uusimman version, yksilöllisellä tuotetunnisteella EN 18219 -standardin mukaisesti.
  • ReadDPPVersionByIdAndDate palauttaa passin version, joka on voimassa tiettynä päivänä ja kellonaikana, UTC-ajassa, ISO 8601-1 -standardin mukaisesti kirjoitettuna.
  • ReadDPPIdsByProductIds palauttaa passitunnisteet, jotka vastaavat joukkoa tuotetunnisteita.
  • CreateDPP luo passin ja palauttaa sen tunnisteen.
  • UpdateDPPById lähettää vain muuttuvat osat. Jos yksi osa epäonnistuu, koko päivitys epäonnistuu eikä mikään muutu. Jokainen muutos arkistoidaan, kuten EN 18221 edellyttää.
  • DeleteDPPById poistaa passin sen elinkaaren lopussa, jos käyttöoikeussäännöt sallivat sen.

Kunkin kutsun osalta käyttöoikeussäännöt ratkaisevat, mitkä tietoelementit palautetaan ja onko muutos sallittu.

HTTPS-polut (kohta 8.2)

KutsuMenetelmä ja polku
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}

Kohta 8.1 lisää, että polussa oleva tunniste pitäisi prosenttikoodata ja että päivityksissä voidaan käyttää RFC 7396 -määrittelyä (JSON merge patch). Kohta 4.1 suosittelee EN 18216 -standardin mukaista sisältöneuvottelua, kun kutsu voi vastata useammassa kuin yhdessä muodossa.

Virheet (kohta 7.2)

Epäonnistuneen kutsun pitäisi palauttaa tulosobjekti, jossa on yksi tai useampi viesti. Jokaisella viestillä on tyyppi (Info, Warning, Error tai Exception) ja teksti, ja siinä voi olla koodi ja aika. Taulukko 15 yhdistää tilakoodit HTTP-koodeihin: esimerkiksi 400 virheelliselle pyynnölle, 401 puuttuville tunnistetiedoille, 404 kun kohdetta ei löydy, 405 menetelmälle, joka ei ole sallittu, ja 409 resurssille, joka on jo olemassa.

Miten dpp-backup.com käyttää sitä

  • Alustasi lähettää kutsuilla CreateDPP ja UpdateDPPById kohdan 8.2 poluissa osoitteen https://dpp-backup.com/api/v1 alla.
  • Päivitykset ovat JSON merge patch -korjauksia. Jos yhdistetty passi ei ole kelvollinen, mitään ei tallenneta.
  • Hylätty kutsu saa kohdan 7.2 tulosobjektin.
  • Neljä lukukutsua vastaa kopiosta verkkotunnuksessa, joka on avattu lukemista varten.

Dokumentaatio · EN 18221

Säilytä passiesi varmuuskopio

Luo organisaatio yrityksesi sähköpostiosoitteella. Kun se on hyväksytty, yhdistät alustan, jossa passisi ovat.

Tarvitset yrityksen sähköpostiosoitteen. Henkilökuntamme käsittelee uudet organisaatiot arkipäivisin. Portaali on englanninkielinen.