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.

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