TracePass
Prodotti

Elencare i prodotti

Elenco paginato di ogni prodotto posseduto dallo spazio di lavoro, ordinato per `createdAt` decrescente. Dimensione della pagina limitata a 100. Filtrate per slug di categoria, status (`active` / `archived`), oppure con una ricerca a testo libero su nome + model.

GET/api/v1/products
Scarica OpenAPI 3.1
GET/api/v1/products

Elencare i prodotti

Elenco paginato di ogni prodotto posseduto dallo spazio di lavoro, ordinato per `createdAt` decrescente. Dimensione della pagina limitata a 100. Filtrate per slug di categoria, status (`active` / `archived`), oppure con una ricerca a testo libero su nome + model.

Conta come una lettura v1 sul contatore `maxV1PassportsPerDay` (il budget lato lettura — lo stesso contatore dell'endpoint di elenco passaporti). Le letture non vengono conteggiate sul budget di scrittura.

Parametri di query

  • page

    number (default 1)

    Numero di pagina su base 1.

  • limit

    number (1-100, default 20)

    Elementi per pagina.

  • category

    string

    Filtra per slug di categoria.

  • status

    string

    `active` o `archived`.

  • search

    string

    Ricerca a testo libero su nome e model.

Header

  • Authorizationobbligatorio

    string

    `Bearer <api-key>`.

Richiesta

curl -sS \
  "https://app.tracepass.eu/api/v1/products?category=batteries&page=1&limit=20" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Risposta

{
  "data": {
    "items": [
      {
        "_id": "6650a1b2c3d4e5f6a7b8c9d0",
        "name": "Li-Ion 48V Battery Pack",
        "model": "BP-48V-100",
        "category": "batteries",
        "passportCount": 12,
        "status": "active",
        "createdAt": "2026-04-10T14:30:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}