Esportazioni

Esportazione massiva JSON-LD per tenant

Restituisce ogni prodotto, ogni passaporto (indipendentemente dallo stato) e ogni template di categoria referenziato che lo spazio di lavoro possiede, come un unico documento JSON-LD. La forma rispecchia l'emissione JSON-LD per singolo passaporto del visualizzatore pubblico, racchiusa in un envelope per tenant con metadati sull'esecuzione dell'esportazione.

GET/api/exports/tenant

Scarica OpenAPI 3.1

GET/api/exports/tenant

Esportazione massiva JSON-LD per tenant

Non raggiungibile tramite chiave API. L'autenticazione è una sessione della dashboard con ruolo admin (o owner) — lo stesso livello di fiducia dell'eliminazione dell'azienda. Disponibile su ogni piano, Free incluso, qualunque sia lo stato dei pagamenti e anche dopo la disdetta (regolamento UE sui dati). Il flusso pragmatico è: aprire Settings → Data export nella dashboard e cliccare "Download JSON-LD". L'accesso programmatico richiede un cookie di sessione emesso da /api/auth/login.

Risposta sincrona con Content-Disposition: attachment; filename="tracepass-tenant-export-<companyId>-<YYYY-MM-DD>.jsonld". Include gli URL dei documenti di prova ma non i byte dei documenti stessi; l'esportazione completa dell'account ("Export everything" nella stessa pagina) aggiunge in un unico ZIP i file originali, le richieste ai fornitori, le versioni dei passaporti, le misurazioni delle batterie e le statistiche delle scansioni. Nessuna impaginazione — tutto o niente.

Header

Cookieobbligatorio
string
Cookie di sessione della dashboard (tp_session=...) emesso da /api/auth/login. I browser lo allegano automaticamente quando l'esportazione viene avviata dalla dashboard.
Accept
string
Non usato: l'esportazione è sempre restituita come application/ld+json, qualunque cosa indichi questa intestazione.

Richiesta

# In practice: open Settings -> Data export in the dashboard.
# For curl, capture the session cookie after a login first:
curl -sS -L \
  --cookie "tp_session=$TRACEPASS_SESSION_COOKIE" \
  -H "Accept: application/ld+json" \
  -o tenant-export.jsonld \
  https://app.tracepass.eu/api/exports/tenant

Risposta

{
  "@context": "https://app.tracepass.eu/schemas/tenant-export-v1.jsonld",
  "@type": "TenantExport",
  "exportedAt": "2026-05-09T12:00:00.000Z",
  "company": { "_id": "...", "name": "Acme Batteries Ltd", "country": "DE" },
  "counts": { "products": 12, "passports": 4327, "templates": 3 },
  "products": [ { "...": "...one entry per product..." } ],
  "passports": [ { "...": "...one entry per passport, with full fieldValues + parties..." } ],
  "templates": [ { "id": "...", "category": "battery", "version": "v3" } ]
}

Endpoint correlati

POSTCreare un passaporto