TracePass
Produkte

Hä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.

GET/api/v1/products/{id}/links
OpenAPI 3.1 herunterladen
GET/api/v1/products/{id}/links

Hä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), csv oder zip.

    e.g. zip

  • limit

    integer (1–5000)

    Zeilen pro Seite, Standard 1000. Nur json.

    e.g. 1000

  • cursor

    string

    Das nextCursor der vorherigen Seite. Nur json.

Header

  • Authorizationerforderlich

    string

    Bearer <token> — entweder ein tp_ 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.zip

Antwort

{
  "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
}