EN 18222 : les appels que propose un prestataire de sauvegarde
Quels appels de l'EN 18222 un prestataire de sauvegarde doit-il proposer ? Selon le point 4.1, trois appels de lecture sont obligatoires : ReadDPPById, ReadDPPByProductId et ReadDPPIdsByProductIds. ReadDataElement, CreateDPP, DeleteDPPById et ReadDPPVersionByIdAndDate sont recommandés. dpp-backup.com les propose tous, sauf ReadDataElement.
L'EN 18222:2026, Passeport numérique de produit – Interfaces de programmation d'applications (API) pour la gestion du cycle de vie et la recherche des passeports de produits, décrit les appels d'une interface de passeport en termes abstraits (article 4) et les fait correspondre à des chemins HTTPS (article 8). La décision d'exécution (UE) 2026/1736 de la Commission la cite comme norme harmonisée au titre de l'ESPR. Cette page résume la norme avec nos propres mots ; elle n'en reproduit pas le texte.
Ce que le point 4.1 demande à un prestataire de sauvegarde
| Appel | EN 18222, 4.1 | dpp-backup.com |
|---|---|---|
| ReadDPPById (4.2) | Doit être proposé | Proposé |
| ReadDPPByProductId (4.3) | Doit être proposé | Proposé |
| ReadDPPIdsByProductIds (4.5) | Doit être proposé | Proposé |
| ReadDataElement (6.2) | Devrait être proposé | Non proposé |
| CreateDPP (4.6) | Devrait être proposé | Proposé |
| DeleteDPPById (4.8) | Devrait être proposé | Répond, et refuse toujours avec 405 : une copie de sauvegarde est conservée pendant toute la durée de vie du passeport |
| ReadDPPVersionByIdAndDate (4.4) | Devrait être proposé | Proposé |
| UpdateDPPById (4.7) | Demandé au créateur ou à son prestataire principal lorsque des tiers peuvent mettre à jour le passeport | Proposé, pour que votre plateforme puisse envoyer chaque modification |
« Doit » (shall) est une exigence de la norme. « Devrait » (should) est une recommandation.
Les appels en bref
- ReadDPPById renvoie le passeport correspondant à un identifiant de passeport connu.
- ReadDPPByProductId renvoie le passeport actif en vigueur, dans sa dernière version, pour un identifiant unique de produit selon l'EN 18219.
- ReadDPPVersionByIdAndDate renvoie la version d'un passeport applicable à une date et une heure données, en UTC, écrites selon l'ISO 8601-1.
- ReadDPPIdsByProductIds renvoie les identifiants de passeport qui correspondent à un ensemble d'identifiants de produit.
- CreateDPP crée un passeport et renvoie son identifiant.
- UpdateDPPById n'envoie que les parties qui changent. Si une partie échoue, toute la mise à jour échoue et rien ne change. Chaque modification est archivée comme le demande l'EN 18221.
- DeleteDPPById supprime un passeport, en fin de vie, si les règles d'accès le permettent.
Pour chaque appel, les règles d'accès déterminent quels éléments de données sont renvoyés et si une modification est autorisée.
Les chemins HTTPS (point 8.2)
| Appel | Méthode et chemin |
|---|---|
| ReadDPPById | GET v1/dpps/{dppId} |
| ReadDPPByProductId | GET v1/dppsByProductId/{productId} |
| ReadDPPVersionByIdAndDate | GET v1/dppsByIdAndDate/{dppId}?date={timestamp} |
| ReadDPPIdsByProductIds | POST v1/dppsByProductIds |
| CreateDPP | POST v1/dpps |
| UpdateDPPById | PATCH v1/dpps/{dppId} |
| DeleteDPPById | DELETE v1/dpps/{dppId} |
Le point 8.1 ajoute qu'un identifiant dans un chemin devrait être encodé en pourcentage, et que la RFC 7396 (JSON merge patch) peut être utilisée pour les mises à jour. Le point 4.1 recommande la négociation de contenu selon l'EN 18216 lorsqu'un appel peut répondre dans plusieurs formats.
Erreurs (point 7.2)
Un appel en échec devrait renvoyer un objet résultat avec un ou plusieurs messages. Chaque message a un type (Info, Warning, Error ou Exception), un texte, et peut avoir un code et un horodatage. Le tableau 15 fait correspondre les codes de statut à HTTP : par exemple 400 pour une requête incorrecte, 401 pour des identifiants d'accès manquants, 404 pour une ressource introuvable, 405 pour une méthode non autorisée et 409 pour une ressource qui existe déjà.
Comment dpp-backup.com l'utilise
- Votre plateforme envoie avec CreateDPP et UpdateDPPById, sur les chemins du point 8.2 sous
https://dpp-backup.com/api/v1. - Les mises à jour sont des JSON merge patches. Si le passeport fusionné n'est pas valide, rien n'est stocké.
- Un appel refusé reçoit l'objet résultat du point 7.2.
- Les quatre appels de lecture répondent à partir de la copie, sur un domaine ouvert à la lecture.
Conservez une copie de sauvegarde de vos passeports
Créez une organisation avec votre adresse e-mail professionnelle. Une fois qu'elle est approuvée, vous connectez la plateforme qui héberge vos passeports.
Une adresse e-mail professionnelle est requise. Notre équipe examine les nouvelles organisations les jours ouvrés. Le portail est en anglais.