Para plataformas de passaportes: dê aos seus clientes uma cópia de segurança

Ligue-se ao dpp-backup.com através da EN 18222. Envie cada passaporte publicado com CreateDPP e cada alteração com UpdateDPPById. Cada versão é armazenada, e recebe um recibo assinado que pode mostrar ao seu cliente.

Porque ajuda os seus clientes

Nos termos do artigo 10.º, n.º 4, do ESPR, o operador económico disponibiliza uma cópia de segurança de cada passaporte através de um prestador de serviços de passaporte digital do produto. Os seus clientes precisam dessa cópia. Com uma ligação ao dpp-backup.com, pode oferecê-la sem ter de construir e gerir um segundo armazenamento.

A EN 18221, 4.5, determina que a replicação para o prestador da cópia de segurança deve ser possível através da interface normalizada de ciclo de vida da EN 18222. É essa a interface que o dpp-backup.com recebe.

Como começa uma ligação

Atualmente, uma ligação começa pela marca. A marca cria a ligação no seu portal e entrega-lhe um endereço e uma credencial. Envia com essa credencial, e o que envia vai apenas para a cópia dessa marca.

O que envia

  • CreateDPP, POST /api/v1/dpps: o passaporte completo, em JSON.
  • UpdateDPPById, PATCH /api/v1/dpps/{dppId}: as partes que mudaram, como JSON merge patch (RFC 7396).
  • Apenas passaportes publicados. Um rascunho é recusado.
  • Um cabeçalho Idempotency-Key, se quiser poder enviar uma chamada novamente em segurança.

O que recebe de volta

Para cada versão armazenada: o seu número, o momento em que foi armazenada, o hash SHA-256 do seu conteúdo e um recibo assinado com Ed25519. O recibo vem na resposta e no cabeçalho Backup-Receipt. O seu cliente pode verificá-lo na página de verificação.

Uma chamada recusada recebe o objeto de resultado da EN 18222, 7.2, com uma frase que indica o que corrigir.

A sua plataforma envia: 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 responde
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..."
  }
}
Uma chamada da EN 18222 e a sua resposta, abreviadas. A documentação descreve cada campo. Dados de exemplo.

Ler a documentação

Em breve

  • Testar sem uma marca Em breve
    Uma credencial de teste para uma plataforma que queira experimentar a interface antes de um cliente a ligar.
  • O selo Em breve
    «Cópia de segurança guardada no dpp-backup.com», para o seu próprio site. Terá uma ligação para uma página que mostra quando chegou a última cópia.

Guarde uma cópia de segurança dos seus passaportes

Crie uma organização com o email da sua empresa. Depois de aprovada, ligue a plataforma que contém os seus passaportes.

É necessário um endereço de email da empresa. A nossa equipa analisa as novas organizações nos dias úteis. O portal está em inglês.