TracePass
Паспорти

Прочитане на флагове за условна класификация

Връща разрешения **condition profile** за паспорт — `Record<flagKey, { value, status, source }>`. Condition flags са одобрени от рецензент факти да/не за продукт, които активират условни правни задължения. За паспорти на батерии по Регламент (ЕС) 2023/1542 регистрираните флагове са: `hasBMS` (наличие на система за управление на батерии), `rechargeable` (батерията е презареждаема), `externalStorageOnly` (прилага се изключение по чл. 8), и `isStationaryBess` (стационарна батерийна система за съхранение на енергия). Категории без регистрирани флагове връщат празен профил.

GET/api/v1/passports/{id}/condition-flags
Изтегли OpenAPI 3.1
GET/api/v1/passports/{id}/condition-flags

Прочитане на флагове за условна класификация

Връща разрешения **condition profile** за паспорт — `Record<flagKey, { value, status, source }>`. Condition flags са одобрени от рецензент факти да/не за продукт, които активират условни правни задължения. За паспорти на батерии по Регламент (ЕС) 2023/1542 регистрираните флагове са: `hasBMS` (наличие на система за управление на батерии), `rechargeable` (батерията е презареждаема), `externalStorageOnly` (прилага се изключение по чл. 8), и `isStationaryBess` (стационарна батерийна система за съхранение на енергия). Категории без регистрирани флагове връщат празен профил.

Одобрен флаг, чиято условие се прилага, прави конкретни полета **задължителни** — например `hasBMS: true` за батерия активира полетата на BMS по Приложение XIII 4(б). Празно задължително поле е **твърда блокада за публикуване** (finding `conditional_missing` при проверка за съответствие). Флаг в статус `pending_review`, отсъстващ или `false` никога не задейства условни изисквания.

Вътрешният масив `audit` е премахнат от v1 отговора за компактност; използвайте таблото за управление за преглед на историята на рецензиите за всеки флаг. Алтернативна форма на адресиране е налична на `GET /api/v1/passports/by-serial/{serial}/condition-flags` със същата форма на отговора. Само за четене; брои се като едно v1 четене на паспорт спрямо дневния лимит.

Параметри в пътя

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

    ObjectId

    ID на паспорта.

Хедъри

  • 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/passports/6650b2c3d4e5f6a7b8c9d0e1/condition-flags \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "passportId": "6650b2c3d4e5f6a7b8c9d0e1",
  "conditionProfile": {
    "hasBMS": {
      "value": true,
      "status": "approved",
      "source": "api:tp_abc123"
    },
    "rechargeable": {
      "value": true,
      "status": "approved",
      "source": "api:tp_abc123"
    }
  }
}