---
title: Renderizzare il QR della pagina del modello
description: "Renderizzare il QR della pagina del modello di un prodotto (/01/{gtin}) come SVG o PNG: per un annuncio online o un rivenditore. Nero su trasparente."
canonical: "https://www.tracepass.eu/it/docs/get-product-model-qr"
locale: it
source: "https://www.tracepass.eu/it/docs/get-product-model-qr"
---

# Renderizzare il QR della pagina del modello

> Renderizzare il QR della pagina del modello di un prodotto (/01/{gtin}) come SVG o PNG: per un annuncio online o un rivenditore. Nero su trasparente.

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

Renderizza il codice QR della pagina del modello del prodotto, l'indirizzo GS1 semplice `/01/{gtin}` elencato in `GET /api/v1/products/{id}/links`. La pagina del modello mostra solo i valori pubblici identici in ogni unità pubblicata, quindi il codice è adatto a un annuncio online o a un rivenditore; ogni unità mantiene il proprio passaporto. Nero su sfondo trasparente. Conta come una lettura v1.

Risponde 404 `model_not_found` quando il prodotto non ha un passaporto GS1 pubblicato con quel GTIN (quindi nessuna pagina del modello), 400 `invalid_gtin` quando `gtin` non è di 14 cifre e 400 `gtin_required` quando i passaporti pubblicati del prodotto riportano più di un GTIN e `gtin` manca.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `Bearer <token>` — una chiave API `tp_` (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes. |
| `id` | path | string (24 hex chars) | yes | ID del prodotto. |
| `format` | query | string | no | `svg` (default) o `png`. |
| `gtin` | query | string (14 digits) | no | Necessario solo quando i passaporti pubblicati del prodotto riportano più di un GTIN. |

## 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 richiesto

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

### 404 — Nessuna pagina del modello

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

## Related

- [Ottenere il pacchetto di link per rivenditori](https://www.tracepass.eu/it/docs/get-product-links.md)
- [Renderizzare il QR del passaporto](https://www.tracepass.eu/it/docs/passport-qr.md)
