TracePass
Започнете
Регулаторен асистент

Задължителни полета

Връща задължителните и очакваните полета за паспорт от дадената категория, с члена от регламента на ЕС, на който се основава всяко поле, нивото му на достъп (публично / ограничено / от власти) и — за батерии — дали данните обикновено се съхраняват от производителя, доставчик или оператора. Без `group` endpoint-ът връща обобщение: общи бройки по група и ниво на достъп, плюс `requiredByHolder` (само за батерии). С `group` — пълния списък с полета за тази група.

GET/api/v1/regulatory/required-fields
Изтегли OpenAPI 3.1
GET/api/v1/regulatory/required-fields

Задължителни полета

Връща задължителните и очакваните полета за паспорт от дадената категория, с члена от регламента на ЕС, на който се основава всяко поле, нивото му на достъп (публично / ограничено / от власти) и — за батерии — дали данните обикновено се съхраняват от производителя, доставчик или оператора. Без `group` endpoint-ът връща обобщение: общи бройки по група и ниво на достъп, плюс `requiredByHolder` (само за батерии). С `group` — пълния списък с полета за тази група.

Достъпно при всеки план. Брои един отговор към ограничението за компания (~100/ден, ~30/мин, споделено между таблото, API и DPP Асистента). При достигане на ограничението се връща 429 `scope_answer_cap`. Непознато `category` връща 400 `invalid_input` с разрешения списък.

Добавете `X-Source: assistant` при извикване от DPP Assistant MCP сървъра — отговорът се подписва от асистента и се прилага портата на OAuth акаунта (необходим е потвърден имейл, не от временен доставчик). API ключовете заобикалят портата.

Query параметри

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

    string

    Ключ на категорията шаблон — напр. `battery`, `detergents`, `toys`. Връща 400 `invalid_input` с `allowed` списъка при непознат ключ.

    e.g. detergents

  • group

    string

    Ключ на групата от шаблона (полето `category` на всяко поле). При липса — обобщение; при наличие — пълен списък с полета за групата.

    e.g. general_info

  • subType

    string

    Подтип батерия — `EV`, `LMT` или `industrial_gt_2kwh`. Филтрира `requiredBy` по същия начин като двигателя за съответствие. Връща 400 при непознат подтип.

    e.g. industrial_gt_2kwh

  • locale

    string

    Език на отговора за текста в `answer` — `en`, `bg`, `de` или `it`. По подразбиране от `Accept-Language`, след това `en`.

    e.g. en

Хедъри

  • 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/regulatory/required-fields?category=detergents&locale=en" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "status": "answered",
  "answer": "detergents passports require 12 fields now, with 4 additional fields anticipated.",
  "locale": "en",
  "data": {
    "category": "detergents",
    "locale": "en",
    "summary": {
      "requiredNow": 12,
      "anticipated": 4,
      "optional": 61,
      "byGroup": {
        "product_id": { "required": 4, "anticipated": 0, "dynamic": 0, "total": 11 },
        "economic_operator": { "required": 6, "anticipated": 0, "dynamic": 0, "total": 11 },
        "composition": { "required": 0, "anticipated": 1, "dynamic": 0, "total": 11 },
        "data_carrier": { "required": 2, "anticipated": 3, "dynamic": 0, "total": 8 },
        "…": {}
      },
      "byAccessTier": { "public": 64, "restricted": 10, "authority": 3 }
    }
  },
  "profileUsed": [],
  "learnable": [],
  "citations": [
    { "celex": "32026R0405", "ref": "Annex VI Part A, point (a)", "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32026R0405" },
    "…"
  ],
  "ruleIds": [],
  "asOf": "2026-10-09",
  "ruleStatus": "verified",
  "machineTranslated": false,
  "disclaimer": "Regulatory information as of 9 Oct 2026, not legal advice. Check the cited articles before relying on it. — TracePass"
}

Свързани endpoints