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łanieEN 18222 4.1dpp-backup.com
ReadDPPById (4.2)Musi być udostępnianeUdostępniane
ReadDPPByProductId (4.3)Musi być udostępnianeUdostępniane
ReadDPPIdsByProductIds (4.5)Musi być udostępnianeUdostępniane
ReadDataElement (6.2)Powinno być udostępnianeNieudostępniane
CreateDPP (4.6)Powinno być udostępnianeUdostępniane
DeleteDPPById (4.8)Powinno być udostępnianeOdpowiada i zawsze odrzuca z kodem 405: kopia zapasowa jest przechowywana przez cały okres życia paszportu
ReadDPPVersionByIdAndDate (4.4)Powinno być udostępnianeUdostępniane
UpdateDPPById (4.7)Wymagane od twórcy lub jego głównego dostawcy, gdy strony trzecie mogą aktualizować paszportUdostę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łanieMetoda i ścieżka
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}

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.

Dokumentacja · EN 18221

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.