TracePass
Prodotti

Leggere un singolo prodotto

Legge un prodotto per ID. Restituisce il documento completo, inclusi i valori predefiniti dei campi, gli URL delle immagini, il riferimento al template e il `passportCount` corrente. Conta come una lettura v1.

GET/api/v1/products/{id}
Scarica OpenAPI 3.1
GET/api/v1/products/{id}

Leggere un singolo prodotto

Legge un prodotto per ID. Restituisce il documento completo, inclusi i valori predefiniti dei campi, gli URL delle immagini, il riferimento al template e il `passportCount` corrente. Conta come una lettura v1.

Parametri di percorso

  • idobbligatorio

    ObjectId

    ID del prodotto.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

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/products/6650a1b2c3d4e5f6a7b8c9d0 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Risposta

{
  "_id": "6650a1b2c3d4e5f6a7b8c9d0",
  "name": "Li-Ion 48V Battery Pack",
  "model": "BP-48V-100",
  "category": "batteries",
  "templateId": "6650a1b2c3d4e5f6a7b8c9d1",
  "defaultFieldValues": {
    "batteryChemistry": "NMC",
    "nominalVoltage": 48
  },
  "imageUrls": [
    "https://cdn.example.com/products/battery-pack-hero.jpg"
  ],
  "passportCount": 12,
  "status": "active",
  "createdAt": "2026-04-10T14:30:00.000Z",
  "updatedAt": "2026-04-12T09:15:00.000Z"
}