TracePass
Loslegen
Pässe

Pass-QR rendern

Liefert einen frisch gerenderten QR-Code für den Pass, der dessen effektive Bezeichner-URI kodiert. Bei GS1-Pässen ist dies die GS1-Digital-Link-URI (/01/<gtin>/21/<serial>); bei ISO 15459 der Resolver-Pfad; bei iec61406-, did- und doi-Pässen der /x/<scheme>/<encodedValue>-Resolver-Pfad (z. B. https://id.tracepass.eu/x/did/<encodedDid>). Alle fünf EN-18219-Schemas lösen zum selben öffentlichen Viewer auf. Nutzen Sie dies, wenn Sie unseren Renderer wollen (konsistente Quiet Zone, Fehlerkorrektur, optionales Branding), statt die URI selbst zu kodieren. Standard ist image/svg+xml; ?format=png liefert ein PNG und ?format=json einen { result: "<svg>" }-Wrapper zum Einbetten.

GET/api/v1/passports/{id}/qr
OpenAPI 3.1 herunterladen
GET/api/v1/passports/{id}/qr

Pass-QR rendern

Liefert einen frisch gerenderten QR-Code für den Pass, der dessen effektive Bezeichner-URI kodiert. Bei GS1-Pässen ist dies die GS1-Digital-Link-URI (/01/<gtin>/21/<serial>); bei ISO 15459 der Resolver-Pfad; bei iec61406-, did- und doi-Pässen der /x/<scheme>/<encodedValue>-Resolver-Pfad (z. B. https://id.tracepass.eu/x/did/<encodedDid>). Alle fünf EN-18219-Schemas lösen zum selben öffentlichen Viewer auf. Nutzen Sie dies, wenn Sie unseren Renderer wollen (konsistente Quiet Zone, Fehlerkorrektur, optionales Branding), statt die URI selbst zu kodieren. Standard ist image/svg+xml; ?format=png liefert ein PNG und ?format=json einen { result: "<svg>" }-Wrapper zum Einbetten.

Standardmäßig ist der QR schwarz auf transparentem Hintergrund. Mit ?useCompanyBranding=true wird die Markenfarbe verwendet, oder ?color=FF6600 (6-stelliges Hex, ohne #) für eine explizite Vordergrundfarbe — ein explizites color schlägt das Branding. ?backgroundColor=FFFFFF ergänzt eine deckende Hintergrundfarbe (8-stelliges Hex = RGBA für Teiltransparenz).

Alternative Adressierung: GET /api/v1/passports/by-serial/{serial}/qr nimmt dieselben Query-Params und akzeptiert den ?gtin=-Disambiguator, wenn eine Seriennummer über Ihre GTINs hinweg nicht eindeutig ist. Jeder Aufruf zählt als ein Pass-Lesevorgang gegen das Tageslimit.

Ein im Dashboard ohne Produktidentifikator angelegter Pass ("Später hinzufügen") hat keinen QR-Code, bis der Identifikator gesetzt ist: Der Aufruf antwortet mit 409 identifier_required. Über die API angelegte Pässe haben immer einen Identifikator.

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Pass-ID.

Query-Parameter

  • format

    string

    svg (Standard), png oder json.

    e.g. png

  • symbology

    string

    qr (Standard) oder datamatrix (ISO/IEC 16022). EN 18220 lässt beide zu; beide codieren dieselbe Pass-URL. Data Matrix eignet sich für kleine Teile und Direktmarkierung.

    e.g. datamatrix

  • useCompanyBranding

    boolean

    Den QR in der Markenfarbe statt Schwarz rendern.

  • color

    string (hex, no #)

    Explizite 6-stellige Hex-Vordergrundfarbe — schlägt das Branding.

    e.g. FF6600

  • backgroundColor

    string (hex, no #)

    Deckende Hintergrundfarbe, 6- oder 8-stelliges Hex (8 = RGBA).

    e.g. FFFFFF

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/passports/6650b2c3d4e5f6a7b8c9d0e1/qr \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o passport-qr.svg

# Branded PNG
curl -sS \
  "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png&color=FF6600" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o passport-qr.png

# Data Matrix instead of QR (EN 18220 permits both)
curl -sS   "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png&symbology=datamatrix"   -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o passport-datamatrix.png

Antwort

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 29 29">
  <!-- QR modules encoding the GS1 Digital Link URI -->
</svg>

Verwandte Endpoints