TracePass
Започнете
Шаблони

Списък на шаблоните по категория

Връща списък на DPP шаблоните по категория — полевите схеми (батерии, текстил, електроника, …). Всеки запис дава ключа на категорията, нейния английски етикет, общия и задължителния брой полета, приложимия регламент и версията на шаблона. Шаблоните са глобални справочни данни, не са обвързани с компания.

GET/api/v1/templates
Изтегли OpenAPI 3.1
GET/api/v1/templates

Списък на шаблоните по категория

Връща списък на DPP шаблоните по категория — полевите схеми (батерии, текстил, електроника, …). Всеки запис дава ключа на категорията, нейния английски етикет, общия и задължителния брой полета, приложимия регламент и версията на шаблона. Шаблоните са глобални справочни данни, не са обвързани с компания.

Използвайте това, за да откриете какво изисква съвместим паспорт в дадена категория, *преди* да създадете продукти и паспорти. За да прочетете пълната схема поле по поле за една категория, извикайте `GET /api/v1/templates/{category}`.

`requiredFieldCount` е стойността, независеща от категорията. Когато задължителността зависи от продуктовата категория, записът съдържа и `requiredFieldCountByCategory` — при батериите е така, защото Регламентът за батериите изисква различни данни от различните видове батерии. Използвайте тази карта вместо единичното число: при батериите общата стойност е по-ниска от действителната за всяка категория в обхвата, защото не включва полетата, които стават задължителни едва след определяне на категорията батерия. Имайте предвид също, че само батериите за електрически превозни средства (EV), за леки транспортни средства (LMT) и индустриалните над 2 kWh изобщо се нуждаят от паспорт за батерия; портативните и стартерните (SLI) са извън обхвата, така че за тях няма задължителни полета.

Това е нискочестотно извикване за откриване, затова не се брои към дневния лимит за четене. Удостоверяването е `tp_` API ключ или OAuth token със scope `passports:read`.

Хедъри

  • Authorizationзадължително

    string

    `Bearer <token>` — или `tp_` API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Заявка

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

Отговор

{
  "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
    }
  ]
}

Свързани endpoints