Für Integratoren

Die Schnittstelle zum Batteriepass

Pflichtmethoden nach EN 18222 Tabelle 17 über dem Datenmodell aus EN 18223. Die OpenAPI-Datei beschreibt jeden Aufruf vollständig. Sie ist die Übergabe an Integratoren und ersetzt das Lesen unseres Codes.

OpenAPI 3.1 herunterladen (YAML)Daten ohne Schlüssel vorprüfen

Lesen braucht keinen Schlüssel

Anhang XIII Punkt 1 der VO (EU) 2023/1542 ist per Definition öffentlich, und EN 18222 kennt dafür keinen Zugangsvorbehalt. Ein Schlüssel hebt die Sichtbarkeitsstufe. Er schaltet die Schnittstelle nicht frei.

Die Antwort trägt keinen Umschlag

Wer ein DPP-Objekt erwartet, findet DigitalProductPassportID unter „data“, nicht unter „data.data“. Das Ergebnisobjekt nach Tabelle 14 steht daneben unter „result“.

Endpunkte

Pfad und Methode im Überblick. Parameter, Antwortformen und Fehlercodes stehen in der Spezifikation: dort und nur dort, damit keine zweite Beschreibung entsteht, die auseinanderläuft.

Lesen und Auflösen

GET/api/dpp/v1/dppsByIdAndDate/{dppId}
GET/api/dpp/v1/dppsByProductId/{productId}
GET/api/dpp/v1/dppsByProductIdAndDate/{productId}
POST/api/dpp/v1/dppsByProductIds

Anlegen und Ändern

GETPATCHDELETE/api/dpp/v1/dpps/{dppId}
GETPATCH/api/dpp/v1/dpps/{dppId}/collections/{elementId}
GETPATCH/api/dpp/v1/dpps/{dppId}/elements/{elementPath}
POST/api/dpp/v1/dpps

Semantik

GET/api/dpp/v1/context
GET/api/dpp/v1/context/{version}
GET/api/dpp/v1/vocab
GET/api/dpp/v1/dict/{key}/{version}

Nachweis

GET/api/v1/dpps/{uid}/proof

Zugang über die öffentliche Stufe hinaus

Recycler, Reparaturbetriebe, benannte Stellen und Marktaufsicht sehen mehr als die Öffentlichkeit. Ein Schlüssel trägt genau eine dieser Rollen und gehört zu genau einem Mandanten; ausgestellt wird er von uns, nicht über ein Anmeldeformular.

So entsteht und lebt ein Pass