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
19 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 nodeVerificare la credenziale di un passaporto
Scaricate la credenziale W3C firmata di un passaporto, risolvete la chiave did:web e verificate la firma ES256 da soli, con curl, Node o Python.
Esplora Verificare la credenziale di un passaportoErrori 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