Per le piattaforme per i passaporti: offrite ai vostri clienti una copia di backup

Collegatevi a dpp-backup.com tramite EN 18222. Inviate ogni passaporto pubblicato con CreateDPP e ogni modifica con UpdateDPPById. Ogni versione viene archiviata e ricevete una ricevuta firmata che potete mostrare al vostro cliente.

Perché è utile ai vostri clienti

Ai sensi dell'articolo 10, paragrafo 4, dell'ESPR, l'operatore economico mette a disposizione una copia di backup di ciascun passaporto tramite un prestatore di servizi per il passaporto digitale del prodotto. I vostri clienti hanno bisogno di questa copia. Con un collegamento a dpp-backup.com potete offrirla senza dover costruire e gestire voi stessi un secondo archivio.

Il punto 4.5 della EN 18221 stabilisce che la replica presso il prestatore di backup deve essere possibile tramite l'interfaccia standard del ciclo di vita della EN 18222. È l'interfaccia che dpp-backup.com accetta.

Come inizia un collegamento

Oggi un collegamento parte dal marchio. Il marchio crea il collegamento nel proprio portale e vi fornisce un indirizzo e una credenziale. Inviate con quella credenziale, e ciò che inviate va solo alla copia di quel marchio.

Che cosa inviate

  • CreateDPP, POST /api/v1/dpps: il passaporto completo, in JSON.
  • UpdateDPPById, PATCH /api/v1/dpps/{dppId}: le parti modificate, come JSON merge patch (RFC 7396).
  • Solo passaporti pubblicati. Una bozza viene rifiutata.
  • Un'intestazione Idempotency-Key se volete poter inviare di nuovo una chiamata in sicurezza.

Che cosa ricevete

Per ogni versione archiviata: il suo numero, il momento dell'archiviazione, l'hash SHA-256 del contenuto e una ricevuta firmata con Ed25519. La ricevuta si trova nella risposta e nell'intestazione Backup-Receipt. Il vostro cliente può verificarla nella pagina di verifica.

Una chiamata rifiutata riceve l'oggetto risultato del punto 7.2 della EN 18222, con una frase che indica che cosa correggere.

La vostra piattaforma invia: CreateDPP
POST /api/v1/dpps HTTP/1.1
Host: dpp-backup.com
Authorization: Bearer <credential>
Content-Type: application/json

{
  "digitalProductPassportId": "5b1d3a8e-0c3f-4a8e-9a77-2f1f3c9b7e01",
  "uniqueProductIdentifier": "https://id.example.com/01/07300000000011",
  "dppStatus": "active",
  "lastUpdated": "2026-11-20T09:14:00Z",
  "productName": "Merino crew neck"
}
dpp-backup.com risponde
HTTP/1.1 201 Created
Backup-Receipt: eyJ2IjoxLCJrZXlfaWQiOi...

{
  "digitalProductPassportId": "5b1d3a8e-0c3f-4a8e-9a77-2f1f3c9b7e01",
  "x-backup": {
    "versionNumber": 1,
    "receivedAt": "2026-11-20T09:14:02.318Z",
    "contentSha256": "5ef66f44…1d1c42",
    "receipt": "eyJ2IjoxLCJrZXlfaWQiOi..."
  }
}
Una chiamata EN 18222 e la sua risposta, abbreviate. La documentazione elenca ogni campo. Dati di esempio.

Leggete la documentazione

In arrivo

  • Test senza un marchio In arrivo
    Una credenziale di prova per una piattaforma che vuole provare l'interfaccia prima che un cliente la colleghi.
  • Il badge In arrivo
    «Copia di backup conservata presso dpp-backup.com», per il vostro sito. Rimanderà a una pagina che mostra quando è arrivata l'ultima copia.

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.