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}`.

È 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": 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
    }
  ]
}

Endpoint correlati