TracePass
Loslegen
Produkte

Produkte auflisten

Paginierte Liste aller Produkte des Workspaces, absteigend nach `createdAt` sortiert. Seitengröße max. 100. Filter nach Kategorie-Slug, Status (`active` / `archived`) oder Freitextsuche über name + model.

GET/api/v1/products
OpenAPI 3.1 herunterladen
GET/api/v1/products

Produkte auflisten

Paginierte Liste aller Produkte des Workspaces, absteigend nach `createdAt` sortiert. Seitengröße max. 100. Filter nach Kategorie-Slug, Status (`active` / `archived`) oder Freitextsuche über name + model.

Zählt als ein v1-Lesevorgang gegen `maxV1PassportsPerDay` — derselbe Zähler wie die Passport-Listen-Endpoint.

Query-Parameter

  • page

    number (default 1)

    1-basierte Seitennummer.

  • limit

    number (1-100, default 20)

    Elemente pro Seite.

  • category

    string

    Filter nach Kategorie-Slug.

  • status

    string

    `active` oder `archived`.

  • search

    string

    Freitextsuche.

Header

  • Authorizationerforderlich

    string

    `Bearer <token>` — entweder ein `tp_` API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Anfrage

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

Antwort

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

Verwandte Endpoints