EN 18222: le chiamate offerte da un prestatore di backup

Quali chiamate della EN 18222 deve offrire un prestatore di backup? Ai sensi del punto 4.1, tre chiamate di lettura sono obbligatorie: ReadDPPById, ReadDPPByProductId e ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById e ReadDPPVersionByIdAndDate sono raccomandate. dpp-backup.com le offre tutte tranne ReadDataElement.

La EN 18222:2026, Digital Product Passport – Application Programming Interfaces (APIs) for the product passport lifecycle management and searchability, descrive le chiamate di un'interfaccia per i passaporti in termini astratti (punto 4) e le fa corrispondere a percorsi HTTPS (punto 8). La decisione di esecuzione (UE) 2026/1736 della Commissione la cita come norma armonizzata ai sensi dell'ESPR. Questa pagina riassume la norma con parole nostre; non ne riproduce il testo.

Che cosa chiede il punto 4.1 a un prestatore di backup

ChiamataEN 18222 4.1dpp-backup.com
ReadDPPById (4.2)Deve essere offertaOfferta
ReadDPPByProductId (4.3)Deve essere offertaOfferta
ReadDPPIdsByProductIds (4.5)Deve essere offertaOfferta
ReadDataElement (6.2)Dovrebbe essere offertaNon offerta
CreateDPP (4.6)Dovrebbe essere offertaOfferta
DeleteDPPById (4.8)Dovrebbe essere offertaRisponde, e rifiuta sempre con 405: una copia di backup è conservata per tutta la durata del passaporto
ReadDPPVersionByIdAndDate (4.4)Dovrebbe essere offertaOfferta
UpdateDPPById (4.7)Richiesta a chi crea il passaporto o al suo prestatore principale quando terzi possono aggiornare il passaportoOfferta, così la vostra piattaforma può inviare ogni modifica

«Shall» (deve) indica un requisito della norma. «Should» (dovrebbe) indica una raccomandazione.

Le chiamate in breve

  • ReadDPPById restituisce il passaporto con un id di passaporto noto.
  • ReadDPPByProductId restituisce il passaporto attivo corrente, nella versione più recente, per un identificativo unico del prodotto secondo la EN 18219.
  • ReadDPPVersionByIdAndDate restituisce la versione di un passaporto valida a una data e ora determinate, in UTC, scritte secondo la ISO 8601-1.
  • ReadDPPIdsByProductIds restituisce gli id dei passaporti corrispondenti a un insieme di identificativi di prodotto.
  • CreateDPP crea un passaporto e ne restituisce l'id.
  • UpdateDPPById invia solo le parti che cambiano. Se una parte non riesce, l'intero aggiornamento non riesce e nulla cambia. Ogni modifica viene archiviata come chiede la EN 18221.
  • DeleteDPPById rimuove un passaporto, alla fine della sua vita, se le regole di accesso lo consentono.

Per ogni chiamata, le regole di accesso stabiliscono quali elementi di dati vengono restituiti e se una modifica è consentita.

I percorsi HTTPS (punto 8.2)

ChiamataMetodo e percorso
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}

Il punto 8.1 aggiunge che un id in un percorso dovrebbe essere codificato con percent-encoding e che per gli aggiornamenti si può usare la RFC 7396 (JSON merge patch). Il punto 4.1 raccomanda la negoziazione del contenuto secondo la EN 18216 quando una chiamata può rispondere in più di un formato.

Errori (punto 7.2)

Una chiamata non riuscita dovrebbe restituire un oggetto risultato con uno o più messaggi. Ogni messaggio ha un tipo (Info, Warning, Error o Exception), un testo, e può avere un codice e un orario. La tabella 15 fa corrispondere i codici di stato a HTTP: per esempio 400 per una richiesta errata, 401 per credenziali mancanti, 404 per una risorsa non trovata, 405 per un metodo non consentito e 409 per una risorsa già esistente.

Come lo usa dpp-backup.com

  • La vostra piattaforma invia con CreateDPP e UpdateDPPById, sui percorsi del punto 8.2 sotto https://dpp-backup.com/api/v1.
  • Gli aggiornamenti sono JSON merge patch. Se il passaporto risultante non è valido, non viene archiviato nulla.
  • Una chiamata rifiutata riceve l'oggetto risultato del punto 7.2.
  • Le quattro chiamate di lettura rispondono dalla copia, su un dominio aperto alla lettura.

Documentazione · EN 18221

Conservate una copia di backup dei vostri passaporti

Create un'organizzazione con la vostra email aziendale. Una volta approvata, collegate la piattaforma che gestisce i vostri passaporti.

È richiesto un indirizzo email aziendale. Il nostro personale esamina le nuove organizzazioni nei giorni lavorativi. Il portale è in inglese.