/api/v1/products/{id}/linksHändler-Linkpaket abrufen
Liefert das Händler-Linkpaket eines Produkts: jeden veröffentlichten Pass mit Seriennummer, Pass-URL und Status, plus die URL der Modellseite des Produkts. Es ist die Ein-Aufruf-Antwort auf eine Händleranfrage nach ESPR Artikel 10 Absatz 3 Buchstabe b, die einen Weblink oder eine Kopie des Datenträgers binnen fünf Arbeitstagen nach der Anfrage verlangt.
Aufgelistet werden nur veröffentlichte Pässe; Entwürfe, Pässe in Prüfung, suspendierte, abgelaufene, archivierte und gelöschte bleiben außen vor. Die URLs nutzen die verifizierte eigene Domain des Unternehmens, falls vorhanden. Die Modellseite (/01/{gtin}) ist eine öffentliche Seite nur mit den Werten, die für jede Einheit gelten: Name, Beschreibung und Bilder des Produkts, der Kontakt des Unternehmens und die öffentlichen Feldwerte, die in jedem veröffentlichten Pass identisch sind. Sie enthält keine Daten einer einzelnen Einheit und keine zugangsbeschränkten Daten. Sie ist kein Pass. Ein Produkt, dessen Pässe nicht GS1-adressiert sind, hat keine Modellseite, und models ist leer.
format=json (Standard) ist seitenweise in Pass-ID-Reihenfolge, höchstens limit Zeilen pro Seite (Standard 1000, Maximum 5000); übergeben Sie nextCursor der Antwort als cursor für die nächste Seite. format=csv streamt jeden veröffentlichten Pass mit den Spalten serial, passport_url, status. Es ist ein Maschinenformat, öffnen Sie es also nicht unbedacht in einer Tabellenkalkulation. format=zip enthält passports.csv (tabellenkalkulationssicher), message.txt (ein kurzer Text zum Weiterleiten) und den QR der Modellseite als model-qr-{gtin}.png, und antwortet ab 50.000 veröffentlichten Pässen mit 413 pack_too_large; nutzen Sie dann csv. Das JSON enthält je Pass qrApiUrl, eine API-Route, die Ihre Zugangsdaten braucht, daher steht sie in keiner Datei für Händler. Zählt als ein v1-Lesezugriff.
Pfad-Parameter
- iderforderlich
string (24 hex chars)
Produkt-ID.
e.g. 6650a1b2c3d4e5f6a7b8c9d0
Query-Parameter
- format
string
json(Standard),csvoderzip.e.g. zip
- limit
integer (1–5000)
Zeilen pro Seite, Standard 1000. Nur
json.e.g. 1000
- cursor
string
Das
nextCursorder vorherigen Seite. Nurjson.
Header
- Authorizationerforderlich
string
Bearer <token>— entweder eintp_API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Anfrage
# Paged JSON (default)
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?limit=1000" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
# The file to send to a dealer: passports.csv, message.txt and the model page QR
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?format=zip" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o dealer-pack.zipAntwort
{
"productId": "6650a1b2c3d4e5f6a7b8c9d0",
"productName": "Li-Ion 48V Battery Pack",
"productModel": "BP-48V-100",
"models": [
{
"gtin": "09506000134352",
"modelUrl": "https://id.tracepass.eu/01/09506000134352",
"qrApiUrl": "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?gtin=09506000134352"
}
],
"passports": [
{
"passportId": "6650b2c3d4e5f6a7b8c9d0e1",
"serial": "SN-0001",
"passportUrl": "https://id.tracepass.eu/01/09506000134352/21/SN-0001",
"qrApiUrl": "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png",
"status": "published"
}
],
"nextCursor": null
}