Öffentliche Produktpass-Abfragen (EN 18222)

Öffentliche Produktpass-Abfragen

Jeder kann einen veröffentlichten Produktpass mit diesen drei Methoden lesen. Sie brauchen dafür keinen API-Schlüssel. Die Methoden nutzen die Pfade der EN 18222, der europäischen Norm für Produktpass-APIs.

Basisadresse

Jede Methode beginnt bei https://passportcraft.com. Die eigene Produktpass-Domain einer Marke beantwortet dieselben Methoden für die Produktpässe dieser Marke.

Wenn ein Register den API-Endpunkt eines Produktpasses verlangt (dppApiEndpoint in der EN 18222), geben Sie diese Basisadresse an.

https://passportcraft.com

Methoden

GET/v1/dpps/{dppId}
Einen Produktpass anhand seiner ID lesen.
GET/v1/dppsByProductId/{productId}
Den Produktpass eines Produkts lesen.
POST/v1/dppsByProductIds
Die Produktpass-IDs mehrerer Produkte finden.

Anfrage

curl "https://passportcraft.com/v1/dpps/https%3A%2F%2Fpassportcraft.com%2Fpassport%2F{id}"

Antwort

{
  "digitalProductPassportId": "https://passportcraft.com/passport/{id}",
  "uniqueProductIdentifier": "https://passportcraft.com/01/{gtin}",
  "granularity": "model",
  "dppSchemaVersion": "EN18223:v1.0",
  "dppStatus": "active",
  "lastUpdated": "2026-01-01T00:00:00Z"
}

Kennungen

dppId ist die digitalProductPassportId des Produktpasses, prozentcodiert. Die ID des Produktpasses allein funktioniert ebenfalls.

productId ist der uniqueProductIdentifier des Produktpasses, prozentcodiert. Das ist sein GS1 Digital Link oder, wenn das Produkt keinen Barcode hat, die Adresse seines Produktpasses.

Senden Sie bis zu 500 Produktkennungen als JSON-Array im Anfragetext. Senden Sie jede Kennung genau so, wie der Produktpass sie nennt. Fügen Sie nicht die Prozentcodierung hinzu, die die beiden GET-Methoden brauchen. Die Antwort nennt die gefundenen Produktpass-IDs in der Reihenfolge, in der Sie sie gesendet haben. Eine Produktkennung, die zu keinem veröffentlichten Produktpass passt, fehlt in der Antwort.

limit legt fest, wie viele Produktkennungen eine Seite liest, von 1 bis 100. Ohne Angabe liest eine Seite 50. Solange weitere folgen, enthält paging_metadata.cursor den Wert, den Sie für die nächste Seite als cursor senden.

Darstellung

Der Produktpass kommt standardmäßig in der komprimierten Form. Mit ?representation=full erhalten Sie die vollständige Form, die den Typ jedes Elements nennt.

Browser

Eine Anfrage, die HTML bevorzugt, etwa die eines Browsers, wird auf die Seite des Produktpasses weitergeleitet.

Statuscodes

200	Der Produktpass oder die Liste der Produktpass-IDs.
303	Eine Weiterleitung auf die Seite des Produktpasses, für einen Browser.
400	Die ID, die Produktkennung, der Anfragetext oder ein Abfragewert ist ungültig.
404	Kein veröffentlichter Produktpass passt.
405	Dieser Pfad unterstützt diese Methode nicht.
500	Der Produktpass konnte gerade nicht gelesen werden. Versuchen Sie es in Kürze erneut.
501	Die EN 18222 definiert diese Methode, und wir bieten sie nicht an.

Jeder Fehler außer 501 enthält ein result-Objekt. Es enthält eine Liste von Meldungen mit je messageType, text, code und timestamp. Programme sollten code lesen, denn dieser Wert ändert sich nie.

Diese Methoden lesen nur. Um Produktpässe anzulegen oder zu ändern, nutzen Sie die authentifizierte API.