EN 18222: wywołania udostępniane przez dostawcę kopii zapasowej
Które wywołania EN 18222 musi udostępniać dostawca kopii zapasowej? Zgodnie z punktem 4.1 obowiązkowe są trzy wywołania odczytu: ReadDPPById, ReadDPPByProductId i ReadDPPIdsByProductIds. Zalecane są ReadDataElement, CreateDPP, DeleteDPPById i ReadDPPVersionByIdAndDate. dpp-backup.com udostępnia je wszystkie z wyjątkiem ReadDataElement.
EN 18222:2026, Digital Product Passport – Application Programming Interfaces (APIs) for the product passport lifecycle management and searchability, opisuje wywołania interfejsu paszportu w sposób abstrakcyjny (punkt 4) i odwzorowuje je na ścieżki HTTPS (punkt 8). Decyzja wykonawcza Komisji (UE) 2026/1736 powołuje ją jako normę zharmonizowaną na podstawie ESPR. Ta strona streszcza normę własnymi słowami; nie powiela jej tekstu.
Czego punkt 4.1 wymaga od dostawcy kopii zapasowej
| Wywołanie | EN 18222 4.1 | dpp-backup.com |
|---|---|---|
| ReadDPPById (4.2) | Musi być udostępniane | Udostępniane |
| ReadDPPByProductId (4.3) | Musi być udostępniane | Udostępniane |
| ReadDPPIdsByProductIds (4.5) | Musi być udostępniane | Udostępniane |
| ReadDataElement (6.2) | Powinno być udostępniane | Nieudostępniane |
| CreateDPP (4.6) | Powinno być udostępniane | Udostępniane |
| DeleteDPPById (4.8) | Powinno być udostępniane | Odpowiada i zawsze odrzuca z kodem 405: kopia zapasowa jest przechowywana przez cały okres życia paszportu |
| ReadDPPVersionByIdAndDate (4.4) | Powinno być udostępniane | Udostępniane |
| UpdateDPPById (4.7) | Wymagane od twórcy lub jego głównego dostawcy, gdy strony trzecie mogą aktualizować paszport | Udostępniane, aby Państwa platforma mogła przesyłać każdą zmianę |
„Shall” oznacza wymaganie normy. „Should” oznacza zalecenie.
Wywołania w skrócie
- ReadDPPById zwraca paszport o znanym identyfikatorze paszportu.
- ReadDPPByProductId zwraca bieżący aktywny paszport, w najnowszej wersji, dla unikatowego identyfikatora produktu zgodnego z EN 18219.
- ReadDPPVersionByIdAndDate zwraca wersję paszportu obowiązującą w danym dniu i o danej godzinie, w UTC, zapisanych zgodnie z ISO 8601-1.
- ReadDPPIdsByProductIds zwraca identyfikatory paszportów odpowiadające zbiorowi identyfikatorów produktów.
- CreateDPP tworzy paszport i zwraca jego identyfikator.
- UpdateDPPById przesyła tylko zmieniane części. Jeśli jedna część się nie powiedzie, cała aktualizacja kończy się niepowodzeniem i nic się nie zmienia. Każda zmiana jest archiwizowana zgodnie z wymogiem EN 18221.
- DeleteDPPById usuwa paszport na końcu jego życia, jeśli pozwalają na to reguły dostępu.
Przy każdym wywołaniu reguły dostępu decydują, które elementy danych są zwracane i czy zmiana jest dozwolona.
Ścieżki HTTPS (punkt 8.2)
| Wywołanie | Metoda i ścieżka |
|---|---|
| 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} |
Punkt 8.1 dodaje, że identyfikator w ścieżce powinien być zakodowany procentowo i że do aktualizacji można używać RFC 7396 (JSON merge patch). Punkt 4.1 zaleca negocjację treści zgodnie z EN 18216, gdy wywołanie może odpowiadać w więcej niż jednym formacie.
Błędy (punkt 7.2)
Nieudane wywołanie powinno zwracać obiekt wyniku z jednym lub kilkoma komunikatami. Każdy komunikat ma typ (Info, Warning, Error lub Exception), tekst i może mieć kod oraz czas. Tabela 15 odwzorowuje kody statusu na HTTP: na przykład 400 dla błędnego żądania, 401 dla brakujących danych uwierzytelniających, 404 dla braku zasobu, 405 dla niedozwolonej metody i 409 dla zasobu, który już istnieje.
Jak korzysta z niej dpp-backup.com
- Państwa platforma przesyła dane za pomocą CreateDPP i UpdateDPPById, na ścieżkach z punktu 8.2 pod adresem
https://dpp-backup.com/api/v1. - Aktualizacje są w formacie JSON merge patch. Jeśli scalony paszport jest nieprawidłowy, nic nie zostaje zapisane.
- Odrzucone wywołanie otrzymuje obiekt wyniku z punktu 7.2.
- Cztery wywołania odczytu odpowiadają z kopii w domenie otwartej do odczytu.
Przechowuj kopię zapasową swoich paszportów
Utwórz organizację, używając firmowego adresu e-mail. Po jej zatwierdzeniu podłączają Państwo platformę, w której znajdują się paszporty.
Wymagany jest firmowy adres e-mail. Nowe organizacje sprawdzają nasi pracownicy w dni robocze. Portal jest w języku angielskim.