TracePass
Loslegen
Vorlagen

Kategorie-Vorlagen auflisten

Listet die DPP-Kategorie-Vorlagen auf — die regulatorischen Feldschemata (Batterie, Textil, Elektronik, …). Jeder Eintrag liefert den Kategorieschlüssel, sein englisches Label, die Gesamt- und Pflichtfeldanzahl, die maßgebliche Verordnung und die Vorlagenversion. Vorlagen sind globale Referenzdaten, nicht mandantengebunden.

GET/api/v1/templates
OpenAPI 3.1 herunterladen
GET/api/v1/templates

Kategorie-Vorlagen auflisten

Listet die DPP-Kategorie-Vorlagen auf — die regulatorischen Feldschemata (Batterie, Textil, Elektronik, …). Jeder Eintrag liefert den Kategorieschlüssel, sein englisches Label, die Gesamt- und Pflichtfeldanzahl, die maßgebliche Verordnung und die Vorlagenversion. Vorlagen sind globale Referenzdaten, nicht mandantengebunden.

Damit finden Sie heraus, was ein konformer Pass in einer Kategorie braucht, *bevor* Sie Produkte und Pässe anlegen. Das vollständige Feld-für-Feld-Schema einer Kategorie liefert `GET /api/v1/templates/{category}`.

Dies ist ein niederfrequenter Discovery-Call und zählt daher nicht gegen Ihr tägliches Lese-Limit. Authentifizierung per `tp_` API-Schlüssel oder OAuth-Token mit dem Scope `passports:read`.

Header

  • Authorizationerforderlich

    string

    `Bearer <token>` — entweder ein `tp_` API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Anfrage

curl -sS https://app.tracepass.eu/api/v1/templates \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "templates": [
    {
      "category": "battery",
      "categoryLabel": "Battery",
      "fieldCount": 93,
      "requiredFieldCount": 64,
      "regulation": "EU Battery Regulation 2023/1542",
      "version": 3
    },
    {
      "category": "textile",
      "categoryLabel": "Textile",
      "fieldCount": 61,
      "requiredFieldCount": 38,
      "regulation": "ESPR 2024/1781",
      "version": 2
    }
  ]
}

Verwandte Endpoints