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

Актуализиране на едно поле в паспорт

Patch на едно поле в паспорт. Стойността се валидира спрямо ключа на полето (трябва да съществува в шаблона на паспорта) и се записва с одитен запис, маркиран `via API key <prefix>`. Предпочитайте това пред записване на цялата карта `fields`, когато трябва да актуализирате само едно число — това е по-малко записване, а одитният запис на полето е това, което виждат прегледашите в таблото.

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

Актуализиране на едно поле в паспорт

Patch на едно поле в паспорт. Стойността се валидира спрямо ключа на полето (трябва да съществува в шаблона на паспорта) и се записва с одитен запис, маркиран `via API key <prefix>`. Предпочитайте това пред записване на цялата карта `fields`, когато трябва да актуализирате само едно число — това е по-малко записване, а одитният запис на полето е това, което виждат прегледашите в таблото.

Записванията по подразбиране са `status: "approved"` — интеграциите, задвижвани от API ключ, са доверени по конвенция (за разлика от редакторите в таблото, където не-администратори записват `pending_review`). Заменете с `source: "ai_suggested"` или `source: "supplier"`, ако искате стойността да попадне в опашката за преглед.

Алтернативна форма за адресиране съществува на PATCH /api/v1/passports/by-serial/{serial}/fields/{key} — същото тяло, същият отговор, полезна е когато вашият ERP знае само серийния номер от страна на клиента. Брои се като едно v1 записване. Поддържа Idempotency-Key.

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

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

    ObjectId

    ID на паспорта. За адресиране по сериен номер вместо това използвайте PATCH /api/v1/passports/by-serial/{serial}/fields/{key}.

    e.g. 6650b2c3d4e5f6a7b8c9d0e1

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

    string

    Ключ на полето (snake_case), както е дефиниран в шаблона на паспорта — напр. `nominal_voltage`, `recycled_content_pct`, `country_of_origin`. 400, ако ключът не е в шаблона.

    e.g. rated_capacity_kwh

Хедъри

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

    string

    `Bearer <api-key>`.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

  • Idempotency-Key

    string

    UUID v4 за логическа операция.

Полета в тялото

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

    string | number | boolean | array | object

    Нова стойност. Платформата не преформатира низове в числа — изпратете стойността в типа, който очаква полето на шаблона.

    e.g. 5.24

  • source

    enum

    Маркер за произхода на стойността. Една от: `manual`, `ai_suggested`, `ai_approved`, `reference_db`, `supplier`, `system`. По подразбиране `manual`. `ai_suggested` и `supplier` отиват в опашката за преглед; всички останали пишат като approved.

  • sourceLocale

    string (ISO 639-1)

    Локал на стойността (един от 24-те EU локала). Управлява посоката на превода + езиковото разрешаване на публичния преглед. По подразбиране `sourceLocale` на паспорта, когато е пропуснат.

Заявка

curl -sS -X PATCH \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/fields/rated_capacity_kwh \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "value": 5.24 }'

Отговор

{
  "field": {
    "value": 5.24,
    "source": "manual",
    "status": "approved",
    "accessLevel": "public",
    "sourceLocale": "en",
    "lastUpdatedAt": "2026-05-09T10:30:00.000Z",
    "lastUpdatedBy": "api_key:tp_89b2482d"
  },
  "version": 4
}

Свързани endpoints