Sviluppa con la API TracePass v1
Riferimento per ogni endpoint REST pubblico esposto da TracePass — CRUD dei passaporti, parti, prodotti, webhook, esportazione massiva in JSON-LD. Specifica OpenAPI 3.1 scritta a mano disponibile per il download; funziona con Postman, Insomnia, Bruno e qualsiasi generatore di client OpenAPI.
Prima di iniziare
La REST API v1 di TracePass è la superficie di integrazione che ogni team di prodotto soggetto a ESPR utilizza per creare, aggiornare e pubblicare passaporti digitali di prodotto in scala. Rispecchia il modello dati che il sito marketing, l'interfaccia della piattaforma e le integrazioni MCP / n8n leggono — un passaporto creato via API è byte-identico a uno creato nell'interfaccia, con la stessa copertura di campi del Regolamento (UE) 2024/1781 (ESPR) e la stessa risoluzione QR GS1 Digital Link.
Versionamento. Ogni endpoint si trova sotto /api/v1/…; v1 è una superficie stabile — aggiungiamo campi ed endpoint senza preavviso, e non rimuoviamo né rinominiamo mai. Una v2 verrebbe rilasciata sotto /api/v2/… con 12 mesi di sovrapposizione con v1 prima di qualsiasi deprecazione. La specifica OpenAPI 3.1 è il riferimento canonico; questo testo è una guida sopra di essa.
Autenticazione + limiti di frequenza. Autenticatevi con una chiave API del workspace tramite l'header Authorization: Bearer <key>. I limiti giornalieri si applicano solo a Free (100 scritture v1 / giorno) e Basic (200 / giorno) come protezione anti-abuso del piano gratuito; da Starter a Enterprise non hanno quota giornaliera. Il supporto Idempotency-Key e le indicazioni per i nuovi tentativi al 429 si trovano nelle pagine autenticazione e errori e limiti di frequenza.
Avvio rapido
Create il vostro primo passaporto in cinque minuti — registratevi, generate una chiave API, pubblicate un passaporto, scansionate il QR.
Esplora Avvio rapidoAutenticazione
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.
Esplora AutenticazionePassaporti
11 endpointCreate, aggiornate, sospendete, archiviate e importate in massa passaporti digitali di prodotto. Include il blocco parties per le catene di operatori economici.
Esplora PassaportiProdotti
7 endpointIl livello del catalogo — prodotti, immagini, lotti. Un prodotto può avere molti passaporti (uno per unità serializzata).
Esplora ProdottiTemplate
2 endpointGli schemi di campi delle categorie DPP — scoprite cosa richiede un passaporto conforme in ogni categoria: numero di campi e regolamento, prima di costruirlo.
Esplora TemplateWebhooks
Eventi firmati HMAC per il ciclo di vita dei passaporti. Retry ladder, verifica firma, protezione anti-replay.
Esplora WebhooksEsportazioni
1 endpointEsportazione massiva JSON-LD per tenant — ogni prodotto, passaporto e template che possedete come un unico documento canonico.
Esplora EsportazioniEPCIS 2.0
4 endpointEventi GS1 EPCIS 2.0 — esportate la cronologia di un passaporto, acquisite eventi da partner e ERP, interrogate l'archivio eventi.
Esplora EPCIS 2.0Server MCP
Server MCP — assistenti IA (Claude, Cursor, IDE) gestiscono prodotti, passaporti, eventi EPCIS. Endpoint ospitato o pacchetto npm locale.
Esplora Server MCPn8n community node
Automatizzate TracePass in n8n senza codice — prodotti, passaporti, eventi EPCIS. community node gratuito, installabile da ogni istanza n8n.
Esplora n8n community nodeErrori e limiti di frequenza
Riferimento: codici di stato HTTP, forma dell'envelope di errore, limiti giornalieri sul livello gratuito, indicazioni sui nuovi tentativi.
Esplora Errori e limiti di frequenza