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

История на измерванията

Връща пълната история на измерванията за паспорт, от последно получените към най-старите (по receivedAt). Всеки запис е обект PassportMeasurement с полета _id, passportId, fieldKey, value, measuredAt, receivedAt, externalId?, unit?, materialized (дали този запис е станал текуща стойност на полето в паспорта) и source.

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

История на измерванията

Връща пълната история на измерванията за паспорт, от последно получените към най-старите (по receivedAt). Всеки запис е обект PassportMeasurement с полета _id, passportId, fieldKey, value, measuredAt, receivedAt, externalId?, unit?, materialized (дали този запис е станал текуща стойност на полето в паспорта) и source.

Филтрирайте с ?fieldKey=<key> за конкретно поле, ?from=<ISO 8601> и ?to=<ISO 8601> за ограничаване на прозореца по measuredAt. Размерът на страницата се управлява с ?limit (1–500, по подразбиране 50). Страницирайте с ?cursor=<nextCursor> — подайте стойността nextCursor от отговора на предишната страница точно така, както е върната; тя е непрозрачна и вътрешният й формат не трябва да се разчита. Отговорът съдържа hasMore: true и ненулев nextCursor, когато има допълнителни резултати; hasMore: false означава, че сте достигнали последната страница.

Алтернативна форма на адресиране е налична на GET /api/v1/passports/by-serial/{serial}/measurements със същите параметри и форма на отговора. При несигурен сериен номер добавете ?gtin=<gtin> за разграничаване. Само за четене; OAuth scope: passports:read.

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

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

    string (24 hex chars)

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

Query параметри

  • fieldKey

    string

    Филтриране по единичен ключ на поле (напр. stateOfHealth).

  • from

    string (ISO 8601)

    Измервания с measuredAt ≥ тази стойност.

    e.g. 2027-01-01T00:00:00Z

  • to

    string (ISO 8601)

    Измервания с measuredAt ≤ тази стойност.

    e.g. 2027-03-31T23:59:59Z

  • limit

    integer

    Размер на страницата (1–500, по подразбиране 50).

  • cursor

    string

    Стойността nextCursor от отговора на предишната страница. Непрозрачна — подайте я непроменена; не я разбирайте или конструирайте.

Хедъри

  • 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/measurements?fieldKey=stateOfHealth&limit=50" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "data": [
    {
      "_id": "6750a1b2c3d4e5f6a7b8c9d0",
      "passportId": "6650b2c3d4e5f6a7b8c9d0e1",
      "fieldKey": "stateOfHealth",
      "value": 96.4,
      "measuredAt": "2027-03-01T06:00:00Z",
      "receivedAt": "2027-03-01T06:01:12Z",
      "externalId": "bms-7781-2027-03-01",
      "materialized": true,
      "source": "api:tp_abc123"
    },
    {
      "_id": "6740a1b2c3d4e5f6a7b8c9d0",
      "passportId": "6650b2c3d4e5f6a7b8c9d0e1",
      "fieldKey": "stateOfHealth",
      "value": 97.1,
      "measuredAt": "2027-02-01T06:00:00Z",
      "receivedAt": "2027-02-01T06:00:55Z",
      "materialized": false,
      "source": "api:tp_abc123"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

Свързани endpoints