/api/v1/products/{id}/linksOttenere 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),csvozip.e.g. zip
- limit
integer (1–5000)
Righe per pagina, default 1000. Solo
json.e.g. 1000
- cursor
string
Il
nextCursordella pagina precedente. Solojson.
Header
- Authorizationobbligatorio
string
Bearer <token>— una chiave APItp_(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.zipRisposta
{
"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
}