---
title: TracePass API documentation
description: REST API reference for the TracePass Digital Product Passport platform.
canonical: "https://www.tracepass.eu/it/docs"
locale: it
source: "https://www.tracepass.eu/it/docs"
---

# TracePass API documentation

> REST API reference for the TracePass Digital Product Passport platform.

Reference for the TracePass REST API — products, Digital Product Passports, parties, batches, and the JSON-LD tenant export.

## Avvio rapido

Create il vostro primo passaporto in cinque minuti — registratevi, generate una chiave API, pubblicate un passaporto, scansionate il QR.

- [Avvio rapido](https://www.tracepass.eu/it/docs/quickstart.md)

## Autenticazione

Due metodi di autenticazione — chiave API (Bearer) e OAuth 2.0 con PKCE — più Idempotency-Key per nuovi tentativi sicuri e limiti per piano su v1.

- [Autenticazione](https://www.tracepass.eu/it/docs/authentication.md)

## Passaporti

Create, aggiornate, sospendete, archiviate e importate in massa passaporti digitali di prodotto. Include il blocco parties per le catene di operatori economici.

- [Creare un passaporto](https://www.tracepass.eu/it/docs/create-passport.md)
- [Leggere un singolo passaporto](https://www.tracepass.eu/it/docs/get-passport.md)
- [Renderizzare il QR del passaporto](https://www.tracepass.eu/it/docs/passport-qr.md)
- [Verificare la conformità del passaporto](https://www.tracepass.eu/it/docs/passport-compliance.md)
- [Elencare i passaporti](https://www.tracepass.eu/it/docs/list-passports.md)
- [Aggiornare un campo su un passaporto](https://www.tracepass.eu/it/docs/update-field.md)
- [Upsert di una parte operatore economico](https://www.tracepass.eu/it/docs/upsert-party.md)
- [Sospendere un passaporto](https://www.tracepass.eu/it/docs/suspend-passport.md)
- [Archiviare un passaporto (irreversibile)](https://www.tracepass.eu/it/docs/archive-passport.md)
- [Eliminare un passaporto definitivamente](https://www.tracepass.eu/it/docs/delete-passport.md)
- [Creazione massiva di passaporti](https://www.tracepass.eu/it/docs/batch-create-passports.md)

## Prodotti

Il livello del catalogo — prodotti, immagini, lotti. Un prodotto può avere molti passaporti (uno per unità serializzata).

- [Creare un prodotto](https://www.tracepass.eu/it/docs/create-product.md)
- [Leggere un singolo prodotto](https://www.tracepass.eu/it/docs/get-product.md)
- [Elencare i prodotti](https://www.tracepass.eu/it/docs/list-products.md)
- [Aggiornare un prodotto](https://www.tracepass.eu/it/docs/update-product.md)
- [Caricare un'immagine del prodotto](https://www.tracepass.eu/it/docs/upload-product-image.md)
- [Archiviare un prodotto](https://www.tracepass.eu/it/docs/archive-product.md)
- [Eliminare un prodotto definitivamente](https://www.tracepass.eu/it/docs/delete-product.md)

## Template

Gli schemi di campi delle categorie DPP — scoprite cosa richiede un passaporto conforme in ogni categoria: numero di campi e regolamento, prima di costruirlo.

- [Elencare i template di categoria](https://www.tracepass.eu/it/docs/list-templates.md)
- [Leggere un template di categoria](https://www.tracepass.eu/it/docs/get-template.md)

## Webhooks

Eventi firmati HMAC per il ciclo di vita dei passaporti. Retry ladder, verifica firma, protezione anti-replay.

- [Webhooks](https://www.tracepass.eu/it/docs/webhooks.md)

## Esportazioni

Esportazione massiva JSON-LD per tenant — ogni prodotto, passaporto e template che possedete come un unico documento canonico.

- [Esportazione massiva JSON-LD per tenant](https://www.tracepass.eu/it/docs/tenant-export.md)

## EPCIS 2.0

Eventi GS1 EPCIS 2.0 — esportate la cronologia di un passaporto, acquisite eventi da partner e ERP, interrogate l'archivio eventi.

- [Esportare gli eventi EPCIS di un passaporto](https://www.tracepass.eu/it/docs/passport-epcis-export.md)
- [Acquisire eventi EPCIS](https://www.tracepass.eu/it/docs/capture-events.md)
- [Interrogare un job di acquisizione](https://www.tracepass.eu/it/docs/capture-job.md)
- [Interrogare eventi EPCIS](https://www.tracepass.eu/it/docs/query-events.md)

## Server MCP

Server MCP — assistenti IA (Claude, Cursor, IDE) gestiscono prodotti, passaporti, eventi EPCIS. Endpoint ospitato o pacchetto npm locale.

- [Server MCP](https://www.tracepass.eu/it/docs/mcp.md)

## n8n community node

Automatizzate TracePass in n8n senza codice — prodotti, passaporti, eventi EPCIS. community node gratuito, installabile da ogni istanza n8n.

- [n8n community node](https://www.tracepass.eu/it/docs/n8n.md)

## Errori e limiti di frequenza

Riferimento: codici di stato HTTP, forma dell'envelope di errore, limiti giornalieri sul livello gratuito, indicazioni sui nuovi tentativi.

- [Errori e limiti di frequenza](https://www.tracepass.eu/it/docs/errors.md)