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-Keyse 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.
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"
}
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..."
}
}
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.