EN 18222: as chamadas que um prestador da cópia de segurança oferece

Que chamadas da EN 18222 tem de oferecer um prestador da cópia de segurança? Nos termos da secção 4.1, três chamadas de leitura são obrigatórias: ReadDPPById, ReadDPPByProductId e ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById e ReadDPPVersionByIdAndDate são recomendadas. O dpp-backup.com oferece todas, exceto ReadDataElement.

A EN 18222:2026, Digital Product Passport – Application Programming Interfaces (APIs) for the product passport lifecycle management and searchability, descreve as chamadas de uma interface de passaporte em termos abstratos (secção 4) e faz-lhes corresponder caminhos HTTPS (secção 8). A Decisão de Execução (UE) 2026/1736 da Comissão cita-a como norma harmonizada ao abrigo do ESPR. Esta página resume a norma por palavras nossas; não reproduz o seu texto.

O que a secção 4.1 pede a um prestador da cópia de segurança

ChamadaEN 18222 4.1dpp-backup.com
ReadDPPById (4.2)Deve ser oferecidaOferecida
ReadDPPByProductId (4.3)Deve ser oferecidaOferecida
ReadDPPIdsByProductIds (4.5)Deve ser oferecidaOferecida
ReadDataElement (6.2)Recomenda-se que seja oferecidaNão oferecida
CreateDPP (4.6)Recomenda-se que seja oferecidaOferecida
DeleteDPPById (4.8)Recomenda-se que seja oferecidaResponde, e recusa sempre com 405: uma cópia de segurança é conservada durante toda a vida do passaporte
ReadDPPVersionByIdAndDate (4.4)Recomenda-se que seja oferecidaOferecida
UpdateDPPById (4.7)Pedida ao criador ou ao seu prestador principal quando terceiros podem atualizar o passaporteOferecida, para que a sua plataforma possa enviar cada alteração

«Shall» (deve) é um requisito da norma. «Should» (recomenda-se) é uma recomendação.

As chamadas em resumo

  • ReadDPPById devolve o passaporte com um id de passaporte conhecido.
  • ReadDPPByProductId devolve o passaporte ativo atual, a versão mais recente, para um identificador único do produto de acordo com a EN 18219.
  • ReadDPPVersionByIdAndDate devolve a versão de um passaporte aplicável numa determinada data e hora, em UTC, escrita como na ISO 8601-1.
  • ReadDPPIdsByProductIds devolve os ids de passaporte que correspondem a um conjunto de identificadores de produto.
  • CreateDPP cria um passaporte e devolve o seu id.
  • UpdateDPPById envia apenas as partes que mudam. Se uma parte falhar, toda a atualização falha e nada muda. Cada alteração é arquivada como pede a EN 18221.
  • DeleteDPPById remove um passaporte, no fim da sua vida, se as regras de acesso o permitirem.

Para cada chamada, as regras de acesso decidem que elementos de dados são devolvidos e se uma alteração é permitida.

Os caminhos HTTPS (secção 8.2)

ChamadaMétodo e caminho
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}

A secção 8.1 acrescenta que um id num caminho deve ser codificado com codificação percentual e que o RFC 7396 (JSON merge patch) pode ser usado para atualizações. A secção 4.1 recomenda a negociação de conteúdo como na EN 18216 quando uma chamada pode responder em mais do que um formato.

Erros (secção 7.2)

Uma chamada falhada deve devolver um objeto de resultado com uma ou mais mensagens. Cada mensagem tem um tipo (Info, Warning, Error ou Exception), um texto, e pode ter um código e um momento. O quadro 15 faz corresponder os códigos de estado a HTTP: por exemplo, 400 para um pedido incorreto, 401 para credenciais em falta, 404 para não encontrado, 405 para um método não permitido e 409 para um recurso que já existe.

Como o dpp-backup.com a utiliza

  • A sua plataforma envia com CreateDPP e UpdateDPPById, nos caminhos da secção 8.2 em https://dpp-backup.com/api/v1.
  • As atualizações são JSON merge patches. Se o passaporte resultante não for válido, nada é armazenado.
  • Uma chamada recusada recebe o objeto de resultado da secção 7.2.
  • As quatro chamadas de leitura respondem a partir da cópia, num domínio aberto para leitura.

Documentação · EN 18221

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.