TracePass
Loslegen
Pässe

Pass-QR rendern

Liefert einen frisch gerenderten QR-Code für den Pass, der dessen `gs1.digitalLinkUri` kodiert. 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 `gs1.digitalLinkUri` kodiert. 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.

Pfad-Parameter

  • iderforderlich

    ObjectId

    Pass-ID.

Query-Parameter

  • format

    string

    `svg` (Standard), `png` oder `json`.

    e.g. png

  • 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

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