/api/v1/templatesСписък на шаблоните по категория
Връща списък на DPP шаблоните по категория — полевите схеми (батерии, текстил, електроника, …). Всеки запис дава ключа на категорията, нейния английски етикет, общия и задължителния брой полета, приложимия регламент и версията на шаблона. Шаблоните са глобални справочни данни, не са обвързани с компания.
Използвайте това, за да откриете какво изисква съвместим паспорт в дадена категория, *преди* да създадете продукти и паспорти. За да прочетете пълната схема поле по поле за една категория, извикайте `GET /api/v1/templates/{category}`.
Това е нискочестотно извикване за откриване, затова не се брои към дневния лимит за четене. Удостоверяването е `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": 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
}
]
}