TracePass
Produkte

QR der Modellseite rendern

Rendert den QR-Code der Modellseite des Produkts, der reinen GS1-Adresse /01/{gtin}, die GET /api/v1/products/{id}/links aufführt. Die Modellseite zeigt nur die öffentlichen Werte, die in jeder veröffentlichten Einheit identisch sind, daher eignet sich der Code für ein Online-Angebot oder einen Händler; jede Einheit behält ihren eigenen Pass. Schwarz auf transparentem Grund. Zählt als ein v1-Lesezugriff.

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

QR der Modellseite rendern

Rendert den QR-Code der Modellseite des Produkts, der reinen GS1-Adresse /01/{gtin}, die GET /api/v1/products/{id}/links aufführt. Die Modellseite zeigt nur die öffentlichen Werte, die in jeder veröffentlichten Einheit identisch sind, daher eignet sich der Code für ein Online-Angebot oder einen Händler; jede Einheit behält ihren eigenen Pass. Schwarz auf transparentem Grund. Zählt als ein v1-Lesezugriff.

Antwortet mit 404 model_not_found, wenn das Produkt keinen veröffentlichten GS1-Pass mit dieser GTIN hat (also keine Modellseite), mit 400 invalid_gtin, wenn gtin nicht 14 Ziffern hat, und mit 400 gtin_required, wenn die veröffentlichten Pässe des Produkts mehr als eine GTIN tragen und gtin fehlt.

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Produkt-ID.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

Query-Parameter

  • format

    string

    svg (Standard) oder png.

    e.g. png

  • gtin

    string (14 digits)

    Nur nötig, wenn die veröffentlichten Pässe des Produkts mehr als eine GTIN tragen.

    e.g. 09506000134352

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

# SVG (default)
curl -sS https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.svg

# PNG for one GTIN
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?format=png&gtin=09506000134352" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.png

Antwort

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 29 29">
  <!-- QR modules encoding https://id.tracepass.eu/01/<gtin> -->
</svg>