/api/v1/templates/{category}Kategorie-Vorlage lesen
Liefert das vollständige regulatorische Feldschema einer DPP-Kategorie — jedes Feld mit Schlüssel, englischem Label, Datentyp, Pflicht-Flag, Zugriffsebene, Validierungsgrenzen, Enum-Optionen (sofern zutreffend) und dem maßgeblichen Verordnungsartikel/-anhang (`regulationRef`). Dies ist die Abfrage hinter konformitätsbewussten Integrationen und dem Compliance-Copilot des MCP-Servers.
Die Projektion ist schlank für API-/KI-Consumer: interne KI-Hinweise, mehrsprachige Platzhalterkarten und Sortier-Buchhaltung pro Feld entfallen, die regulatorische Substanz bleibt. Labels kommen in kanonischem Englisch; die vollständigen lokalisierten Label-Karten bleiben in der Dashboard-Template-API.
`{category}` ist einer der 12 Kategorieschlüssel (battery, textile, electronics, construction, steel, chemicals, packaging, furniture, tyres, jewelry, toys, fmcg). Eine unbekannte Kategorie liefert 404 mit dem Code `TEMPLATE_NOT_FOUND` — gültige Schlüssel listet `GET /api/v1/templates`.
Pfad-Parameter
- categoryerforderlich
string
Einer der 12 Kategorieschlüssel, z. B. `battery`, `textile`, `electronics`.
e.g. battery
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/battery \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Antwort
{
"category": "battery",
"categoryLabel": "Battery",
"version": 1,
"regulation": "EU Battery Regulation 2023/1542",
"fieldCount": 117,
"requiredFieldCount": 59,
"requiredFieldCountByCategory": {
"EV": 85,
"LMT": 88,
"industrial_gt_2kwh": 70
},
"fields": [
{
"key": "batteryChemistry",
"label": "Battery Chemistry",
"dataType": "string",
"required": true,
"accessLevel": "public",
"category": "materials_composition",
"validation": { "required": true },
"regulationRef": { "article": "Art. 77", "annex": "Annex VI" }
}
]
}