Bauen Sie mit dem TracePass v1 API
Referenz für jeden öffentlichen REST-Endpoint, den TracePass anbietet — Pass-CRUD, Parties, Produkte, Webhooks, Bulk-JSON-LD-Export. Handgeschriebene OpenAPI-3.1-Spezifikation als Download; kompatibel mit Postman, Insomnia, Bruno und jedem OpenAPI-Client-Generator.
Bevor Sie loslegen
Die TracePass v1 REST API ist die Integrationsoberfläche, die jedes ESPR-pflichtige Produktteam nutzt, um Digitale Produktpässe in großem Maßstab zu erstellen, zu aktualisieren und zu veröffentlichen. Sie spiegelt das Datenmodell, das die Marketing-Site, die Plattform-UI und die MCP- / n8n-Integrationen lesen — ein per API erstellter Pass ist byte-identisch mit einem in der UI erstellten, mit derselben Feldabdeckung nach Verordnung (EU) 2024/1781 (ESPR) und derselben GS1-Digital-Link-QR-Auflösung.
Versionierung. Jeder Endpoint liegt unter /api/v1/…; v1 ist eine stabile Oberfläche — wir fügen Felder und Endpoints ohne Vorankündigung hinzu und entfernen oder benennen niemals um. Eine v2 würde unter /api/v2/… ausgeliefert, mit 12 Monaten v1-Überlappung vor jeder Abkündigung. Die OpenAPI-3.1-Spezifikation ist die kanonische Referenz; dieser Text ist ein Leitfaden darüber.
Authentifizierung + Rate-Limits. Authentifizieren Sie sich mit einem Workspace-API-Schlüssel über den Header Authorization: Bearer <key>. Tageslimits gelten nur für Free (100 v1-Schreibvorgänge / Tag) und Basic (200 / Tag) als Missbrauchsschutz für den kostenlosen Tarif; Starter bis Enterprise haben kein Tageskontingent. Unterstützung für Idempotency-Key und 429-Retry-Anleitungen finden Sie auf den Seiten Authentifizierung und Fehler und Rate-Limits.
Schnellstart
Erstellen Sie Ihren ersten Pass in fünf Minuten — registrieren, API-Schlüssel generieren, Pass anlegen, QR scannen.
Durchsuchen SchnellstartAuthentifizierung
Zwei Auth-Methoden — API-Schlüssel (Bearer) und OAuth 2.0 mit PKCE — plus Idempotency-Key für sichere Retries und planabhängige Rate-Limits für v1.
Durchsuchen AuthentifizierungPässe
11 EndpointsPässe erstellen, aktualisieren, suspendieren, archivieren und massenimportieren. Inklusive parties-Block für Wirtschaftsakteurs-Ketten.
Durchsuchen PässeProdukte
7 EndpointsDie Katalogebene — Produkte, Bilder, Chargen. Ein Produkt kann viele Pässe haben (einen pro serialisierter Einheit).
Durchsuchen ProdukteVorlagen
2 EndpointsDie DPP-Kategorie-Feldschemata — finden Sie heraus, was ein konformer Pass je Kategorie braucht: Feldanzahl und maßgebliche Verordnung, bevor Sie ihn erstellen.
Durchsuchen VorlagenWebhooks
HMAC-signierte Event-Zustellung für Pass-Lebenszyklus-Events. Retry-Ladder, Signaturprüfung, Replay-Schutz.
Durchsuchen WebhooksExporte
1 EndpointBulk-JSON-LD-Mandantenexport — alle Produkte, Pässe und Vorlagen Ihres Mandanten als ein kanonisches Dokument.
Durchsuchen ExporteEPCIS 2.0
4 EndpointsGS1-EPCIS-2.0-Ereignisse — Ereignishistorie eines Passes exportieren, Events von Partnern und ERP erfassen, Event-Speicher abfragen.
Durchsuchen EPCIS 2.0MCP-Server
MCP-Server — KI-Assistenten (Claude, Cursor, IDE) verwalten Produkte, Pässe, EPCIS-Ereignisse direkt. Gehosteter Endpoint oder lokales npm-Paket.
Durchsuchen MCP-Servern8n community node
Automatisieren Sie TracePass-Workflows in n8n ohne Code — Produkte, Pässe, EPCIS-Ereignisse. Kostenloser community node, installierbar aus jeder n8n-Instanz.
Durchsuchen n8n community nodeFehler & Rate-Limits
Referenz: HTTP-Statuscodes, Fehler-Envelope-Form, tägliche Aufrufkontingente auf dem kostenlosen Tier, Retry-Anleitung.
Durchsuchen Fehler & Rate-Limits