TracePass
Започнете
Паспорти

Прочитане на паспорт

Прочитане на паспорт по ID. По подразбиране отговорът включва пълен паспорт — преводимите полета носят своя `sourceLocale` и карта `translations` по локал. Подайте `?lang=<locale>`, за да накарате сървъра да разреши всяко поле по веригата на публичния преглед (превод на локала на гледащия → стойност на изходния локал → английски → първи приложен → универсален източник) и да върне една резолвирана стойност за всяко поле; картата `translations` се изхвърля при отговори, разрешени по lang.

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

Прочитане на паспорт

Прочитане на паспорт по ID. По подразбиране отговорът включва пълен паспорт — преводимите полета носят своя `sourceLocale` и карта `translations` по локал. Подайте `?lang=<locale>`, за да накарате сървъра да разреши всяко поле по веригата на публичния преглед (превод на локала на гледащия → стойност на изходния локал → английски → първи приложен → универсален източник) и да върне една резолвирана стойност за всяко поле; картата `translations` се изхвърля при отговори, разрешени по lang.

Подайте `?format=full`, за да включите допълнително template-derived етикети на полета, мерни единици и нива на достъп заедно с всяка стойност — полезно за изграждане на персонализиран viewer или audit report. Двата query параметри се комбинират: `?format=full&lang=de` връща етикетите на DE плюс стойностите, разрешени до DE.

Алтернативна адресация: `GET /api/v1/passports/by-serial/{serial}` връща същата форма и приема същите query параметри. Има също `GET /api/v1/passports/{id}/qr` endpoint, който връща прясно рендериран SVG / PNG на QR кода — полезно, когато искате нашия renderer вместо сами да кодирате `gs1.digitalLinkUri`.

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

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

    ObjectId

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

Query параметри

  • format

    string

    Задайте `full` за template field labels, мерни единици и access levels.

  • lang

    string (ISO 639-1)

    Разрешава стойностите на полетата до един локал на сървъра. Един от 24-те EU локала.

Хедъри

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

    string

    `Bearer <api-key>`.

Заявка

# Default response — full data, consumer resolves locales itself
curl -sS https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

# Single-locale response with template labels
curl -sS \
  "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1?format=full&lang=de" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "_id": "6650b2c3d4e5f6a7b8c9d0e1",
  "gs1": {
    "gtin": "04012345000015",
    "serialNumber": "BP-48V-100-000001",
    "digitalLinkUri": "https://id.tracepass.eu/p/01/04012345000015/21/BP-48V-100-000001"
  },
  "status": "published",
  "completionPercentage": 87,
  "fields": {
    "battery_chemistry": {
      "value": "lithium-ion",
      "source": "manual",
      "status": "approved",
      "accessLevel": "public",
      "sourceLocale": "en",
      "translations": {
        "de": { "value": "Lithium-Ionen", "source": "ai-haiku-4.5", "generatedAt": "2026-05-02T10:00:00.000Z" }
      }
    }
  }
}

Свързани endpoints