---
title: QR der Modellseite rendern
description: "Den QR-Code der Modellseite eines Produkts (/01/{gtin}) als SVG oder PNG rendern: für ein Online-Angebot oder einen Händler. Schwarz auf transparent."
canonical: "https://www.tracepass.eu/de/docs/get-product-model-qr"
locale: de
source: "https://www.tracepass.eu/de/docs/get-product-model-qr"
---

# QR der Modellseite rendern

> Den QR-Code der Modellseite eines Produkts (/01/{gtin}) als SVG oder PNG rendern: für ein Online-Angebot oder einen Händler. Schwarz auf transparent.

```http
GET /api/v1/products/{id}/links/model-qr
```

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.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `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. |
| `id` | path | string (24 hex chars) | yes | Produkt-ID. |
| `format` | query | string | no | `svg` (Standard) oder `png`. |
| `gtin` | query | string (14 digits) | no | Nur nötig, wenn die veröffentlichten Pässe des Produkts mehr als eine GTIN tragen. |

## Examples

```bash
# 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
```

```typescript
const url = new URL(
  `https://app.tracepass.eu/api/v1/products/${id}/links/model-qr`,
);
url.searchParams.set("format", "png");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` },
});
if (!res.ok) throw new Error(`Model QR failed: ${res.status}`);
const pngBytes = new Uint8Array(await res.arrayBuffer());
```

```python
import os, requests
res = requests.get(
    f"https://app.tracepass.eu/api/v1/products/{product_id}/links/model-qr",
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
    params={"format": "png"},
)
res.raise_for_status()
open("model-qr.png", "wb").write(res.content)
```

## Responses

### 200 — SVG

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

### 400 — GTIN erforderlich

```json
{ "error": "gtin_required", "message": "This product has published passports under more than one GTIN; pass ?gtin=.", "gtins": ["09506000134352", "09506000134369"] }
```

### 404 — Keine Modellseite

```json
{ "error": "model_not_found", "message": "This product has no model page for that GTIN." }
```

## Related

- [Händler-Linkpaket abrufen](https://www.tracepass.eu/de/docs/get-product-links.md)
- [Pass-QR rendern](https://www.tracepass.eu/de/docs/passport-qr.md)
