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

Списък на паспортите

Пагиниран списък на паспортите в работното пространство. Филтрирайте по productId, status или free-text търсене по GTIN и сериен номер. Брои се срещу дневния бюджет за четене на паспорти (maxV1PassportsPerDay); елементите на отговора използват същата форма като endpoint-а за единично четене, но скъсена до полетата за списъка.

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

Списък на паспортите

Пагиниран списък на паспортите в работното пространство. Филтрирайте по productId, status или free-text търсене по GTIN и сериен номер. Брои се срещу дневния бюджет за четене на паспорти (maxV1PassportsPerDay); елементите на отговора използват същата форма като endpoint-а за единично четене, но скъсена до полетата за списъка.

Query параметри

  • page

    number (default 1)

    1-базиран номер.

  • limit

    number (1-100, default 20)

    Елементи на страница.

  • productId

    string (24 hex chars)

    Филтър по продукт.

  • status

    enum

    draft, in_review, approved, published, suspended, expired, archived, marked_for_deletion. Изтритите паспорти никога не се показват в списъка.

  • search

    string

    Free-text по GTIN + сериен.

Хедъри

  • 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?status=published&limit=50" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "items": [
    {
      "_id": "6650b2c3d4e5f6a7b8c9d0e1",
      "productId": "6650a1b2c3d4e5f6a7b8c9d0",
      "gs1": {
        "gtin": "04012345000016",
        "serialNumber": "BP-48V-100-000001",
        "digitalLinkUri": "https://id.tracepass.eu/p/01/04012345000016/21/BP-48V-100-000001"
      },
      "status": "published",
      "completionPercentage": 87,
      "publishedAt": "2026-04-11T10:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50,
  "totalPages": 1
}

Свързани endpoints