TracePass
Prodotti

Ottenere il pacchetto di link per rivenditori

Restituisce il pacchetto di link per rivenditori di un prodotto: ogni passaporto pubblicato con seriale, URL del passaporto e stato, più l'URL della pagina del modello del prodotto. È la risposta in una sola chiamata a una richiesta di un rivenditore ai sensi dell'articolo 10, paragrafo 3, lettera b) dell'ESPR, che chiede un link a una pagina web o una copia del supporto dati entro cinque giorni lavorativi dalla richiesta.

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

Ottenere il pacchetto di link per rivenditori

Restituisce il pacchetto di link per rivenditori di un prodotto: ogni passaporto pubblicato con seriale, URL del passaporto e stato, più l'URL della pagina del modello del prodotto. È la risposta in una sola chiamata a una richiesta di un rivenditore ai sensi dell'articolo 10, paragrafo 3, lettera b) dell'ESPR, che chiede un link a una pagina web o una copia del supporto dati entro cinque giorni lavorativi dalla richiesta.

Sono elencati solo i passaporti pubblicati; bozze, passaporti in revisione, sospesi, scaduti, archiviati e eliminati restano fuori. Gli URL usano il dominio personalizzato verificato dell'azienda, se ne ha uno. La pagina del modello (/01/{gtin}) è una pagina pubblica con i soli valori veri per ogni unità: nome, descrizione e immagini del prodotto, il contatto dell'azienda e i valori pubblici dei campi identici in ogni passaporto pubblicato. Non contiene dati di una singola unità né dati ad accesso limitato. Non è un passaporto. Un prodotto i cui passaporti non sono indirizzati con GS1 non ha pagina del modello e models è vuoto.

format=json (default) è paginato in ordine di ID del passaporto, al massimo limit righe per pagina (default 1000, massimo 5000); passate il nextCursor della risposta come cursor per la pagina successiva. format=csv trasmette in streaming ogni passaporto pubblicato con le colonne serial, passport_url, status. È un formato per macchine, quindi non apritelo in un foglio di calcolo senza cautela. format=zip contiene passports.csv (sicuro per i fogli di calcolo), message.txt (un breve testo da inoltrare) e il QR della pagina del modello come model-qr-{gtin}.png, e risponde 413 pack_too_large oltre 50.000 passaporti pubblicati; usate allora csv. Il JSON riporta qrApiUrl per ogni passaporto, una route API che richiede le vostre credenziali, quindi non compare in nessun file destinato a un rivenditore. Conta come una lettura v1.

Parametri di percorso

  • idobbligatorio

    string (24 hex chars)

    ID del prodotto.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

Parametri di query

  • format

    string

    json (default), csv o zip.

    e.g. zip

  • limit

    integer (1–5000)

    Righe per pagina, default 1000. Solo json.

    e.g. 1000

  • cursor

    string

    Il nextCursor della pagina precedente. Solo json.

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

# Paged JSON (default)
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?limit=1000" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

# The file to send to a dealer: passports.csv, message.txt and the model page QR
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?format=zip" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o dealer-pack.zip

Risposta

{
  "productId": "6650a1b2c3d4e5f6a7b8c9d0",
  "productName": "Li-Ion 48V Battery Pack",
  "productModel": "BP-48V-100",
  "models": [
    {
      "gtin": "09506000134352",
      "modelUrl": "https://id.tracepass.eu/01/09506000134352",
      "qrApiUrl": "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?gtin=09506000134352"
    }
  ],
  "passports": [
    {
      "passportId": "6650b2c3d4e5f6a7b8c9d0e1",
      "serial": "SN-0001",
      "passportUrl": "https://id.tracepass.eu/01/09506000134352/21/SN-0001",
      "qrApiUrl": "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png",
      "status": "published"
    }
  ],
  "nextCursor": null
}