TracePass
Inizia ora
Template

Elencare i template di categoria

Elenca i template di categoria DPP — gli schemi di campi normativi (batteria, tessile, elettronica, …). Ogni voce indica la chiave della categoria, la sua etichetta inglese, il numero totale e obbligatorio di campi, il regolamento applicabile e la versione del template. I template sono dati di riferimento globali, non legati all'azienda.

GET/api/v1/templates
Scarica OpenAPI 3.1
GET/api/v1/templates

Elencare i template di categoria

Elenca i template di categoria DPP — gli schemi di campi normativi (batteria, tessile, elettronica, …). Ogni voce indica la chiave della categoria, la sua etichetta inglese, il numero totale e obbligatorio di campi, il regolamento applicabile e la versione del template. I template sono dati di riferimento globali, non legati all'azienda.

Usatelo per scoprire cosa richiede un passaporto conforme in una categoria *prima* di creare prodotti e passaporti. Per leggere lo schema completo campo per campo di una categoria, chiamate `GET /api/v1/templates/{category}`.

`requiredFieldCount` è il valore indipendente dalla categoria. Quando l'obbligatorietà varia in base alla categoria di prodotto, la voce riporta anche `requiredFieldCountByCategory` — è il caso delle batterie, perché il Regolamento UE sulle batterie chiede dati diversi a tipi di batteria diversi. Leggete quella mappa invece del numero singolo: per le batterie il valore complessivo è inferiore a quello reale di ogni categoria nell'ambito, perché non conta i campi che diventano obbligatori solo una volta nota la categoria di batteria. Notate inoltre che solo le batterie EV, LMT e industriali oltre 2 kWh necessitano di un passaporto della batteria; le batterie portatili e di avviamento (SLI) sono fuori ambito, quindi per esse nessun campo è obbligatorio.

È una chiamata di scoperta a bassa frequenza, quindi non conta sul limite giornaliero di letture. L'autenticazione è una chiave API `tp_` o un token OAuth con lo scope `passports:read`.

Header

  • Authorizationobbligatorio

    string

    `Bearer <token>` — una chiave API `tp_` (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Richiesta

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

Risposta

{
  "templates": [
    {
      "category": "battery",
      "categoryLabel": "Battery",
      "fieldCount": 117,
      "requiredFieldCount": 59,
      "requiredFieldCountByCategory": {
        "EV": 85,
        "LMT": 88,
        "industrial_gt_2kwh": 70
      },
      "regulation": "EU Battery Regulation 2023/1542",
      "version": 1
    },
    {
      "category": "textile",
      "categoryLabel": "Textile",
      "fieldCount": 60,
      "requiredFieldCount": 12,
      "regulation": "ESPR 2024/1781",
      "version": 2
    }
  ]
}

Endpoint correlati