TracePass
Inizia ora
Passaporti

Elencare i passaporti

Elenco paginato dei passaporti posseduti dallo spazio di lavoro. Filtrate per productId, status, oppure con una ricerca a testo libero su GTIN e numero di serie. Viene conteggiato sul budget giornaliero di lettura passaporti (maxV1PassportsPerDay); gli elementi della risposta usano la stessa forma dell'endpoint di lettura singola ma ridotta ai campi dell'elenco.

GET/api/v1/passports
Scarica OpenAPI 3.1
GET/api/v1/passports

Elencare i passaporti

Elenco paginato dei passaporti posseduti dallo spazio di lavoro. Filtrate per productId, status, oppure con una ricerca a testo libero su GTIN e numero di serie. Viene conteggiato sul budget giornaliero di lettura passaporti (maxV1PassportsPerDay); gli elementi della risposta usano la stessa forma dell'endpoint di lettura singola ma ridotta ai campi dell'elenco.

Parametri di query

  • page

    number (default 1)

    Numero di pagina su base 1.

  • limit

    number (1-100, default 20)

    Elementi per pagina.

  • productId

    string (24 hex chars)

    Filtra per prodotto.

  • status

    enum

    draft, in_review, approved, published, suspended, expired, archived, marked_for_deletion. I passaporti eliminati non vengono mai elencati.

  • search

    string

    Testo libero su GTIN + numero di serie.

Header

  • Authorizationobbligatorio

    string

    Bearer <token> — una chiave API tp_ (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Richiesta

curl -sS \
  "https://app.tracepass.eu/api/v1/passports?status=published&limit=50" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Risposta

{
  "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
}

Endpoint correlati