Skip to content
Guida del Centro assistenza
3 min di letturaVerificato 2026-11-16

Esportazione dati e report

Esporta elenchi filtrati in CSV manuale, caricamenti programmati FTP/SFTP o endpoint REST di reporting.

In questa guida

Panoramica

Passinstance fornisce endpoint di esportazione dati in streaming in ogni dominio operativo principale — incluse istanze pass (POST /api/v1/passes/export), storici delle scansioni di validazione, chiavi dei dispositivi scanner, report direzionali dashboard, fatture fiscali IVA, archivi per gli interessati GDPR e log di audit di conformità (GET /api/v1/audit-log/export.csv o nella Dashboard su /settings/workspace/developer/audit-logs). Tutte le esportazioni sono rigorosamente limitate al workspace autenticato (Customer) e trasmesse con header MIME standard per l'utilizzo immediato in fogli di calcolo, pipeline ERP o SIEM.

Architettura di esportazione dati multi-dominio

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
MOTORE DI ESPORTAZIONE STREAMING E CONFORMITÀ
FASE 01 LIVELLO RICHIESTE CLIENT E AUTOMAZIONI
UI Esportazione Dashb.
(Viste tabellari filtr.)
Job BI / ERP pianif.
(x-api-key / Bearer)
Conformità e Legale
(GDPR DSR e Audit)
FASE 02 CONTROLLER DI ESPORTAZIONE PASSINSTANCE (API)
Esportazioni operative (CSV UTF-8)
POST/api/v1/passes/export
GET/api/v1/validation/scans/*
GET/api/v1/dashboards/export
Esportazioni finanziarie e GDPR
GET/api/v1/billing/invoices/*
POST .../data-subject-export
GET/api/v1/audit-log/export.csv
FASE 03 FORMATI DI OUTPUT E DESTINAZIONI
text/csv; charset=utf8
Righe escape RFC 4180 (Pass, Scansioni, Chiavi
application/pdf
Fatture fiscali dettagliate & Dashboard
application/json
Archivi GDPR e
JSON Dashboard

Importante: I file CSV e JSON esportati contengono spesso dati personali identificativi (PII) dei titolari dei pass, come nomi, indirizzi e-mail, valori externalId e storici delle transazioni. Conservi ed elimini sempre le esportazioni scaricate in conformità alle policy di conservazione descritte in Privacy dei dati e GDPR.

Catalogo completo degli endpoint di esportazione

Istanze pass
POST
Percorso endpoint
/api/v1/passes/export
Formati di output (Content-Type)
text/csv; charset=utf-8
Descrizione
Trasmette righe CSV (passes-export.csv) per un elenco esplicito fino a 2000 UUID (request payload: { passIds, format: "csv" }).
Storico scansioni config
GET
Percorso endpoint
/api/v1/validation/configs/:id/scans/export
Formati di output (Content-Type)
text/csv; charset=utf-8
Descrizione
Esporta gli eventi di scansione e i riscatti meccaniche limitati a una singola ScannerConfiguration.
Scansioni workspace
GET
Percorso endpoint
/api/v1/validation/scans/export
Formati di output (Content-Type)
text/csv; charset=utf-8
Descrizione
Esporta lo storico delle scansioni di validazione dell'intero workspace tra tutte le configurazioni.
Audit trail scansioni
GET
Percorso endpoint
/api/v1/validation/scan-results/export/csv
Formati di output (Content-Type)
text/csv; charset=utf-8
Descrizione
Traccia di audit granulare completa degli esiti di scansione, inclusi decision, reasonCode, ID operatore ed effetti sul saldo.
Chiavi dispositivi scanner
GET
Percorso endpoint
/api/v1/validation/configs/:id/scanner-keys/export/csv
Formati di output (Content-Type)
text/csv; charset=utf-8
Descrizione
Inventario delle chiavi scanner emesse, stati di abbinamento, date di scadenza e metadati telemetrici del dispositivo.
Riepilogo Dashboard
GET
Percorso endpoint
`/api/v1/dashboards/export?format=csv\
Verbo HTTP
json\
Formati di output (Content-Type)
pdf`
Output job batch
GET
Percorso endpoint
/api/v1/batch-processing/:id/result.csv
Formati di output (Content-Type)
text/csv; charset=utf-8
Descrizione
Scarica le righe elaborate in uscita da un job asincrono di creazione o aggiornamento batch.
Fatture di pagamento
GET
Percorso endpoint
/api/v1/billing/invoices/:id/download
Formati di output (Content-Type)
application/pdf
Descrizione
Trasmette in streaming la fattura fiscale/IVA ufficiale in PDF per uno specifico ciclo di fatturazione.
Interessato GDPR
POST
Percorso endpoint
/api/v1/customer/:customerId/privacy-settings/data-subject-export
Formati di output (Content-Type)
application/json
Descrizione
Genera un payload strutturato per la portabilità ai sensi degli articoli 15/20 GDPR (IDataSubjectExportPayload) corrispondente a request payload.query.
Audit log di sicurezza
GET
Percorso endpoint
/api/v1/audit-log/export.csv
Formati di output (Content-Type)
text/csv; charset=utf-8
Descrizione
Esporta fino a 1000 righe immutabili di attività amministrativa (supporta action, entityType, userId, startDate, endDate, customerId).

Esempi di utilizzo delle API

1. Esportazione CSV delle istanze pass (POST /api/v1/passes/export)

Interroghi gli UUID dei pass corrispondenti tramite GET /api/v1/passes oppure POST /api/v1/passes/query-builder, poi li trasmetta come passes-export.csv tramite POST /api/v1/passes/export (request payload richiede 1–2.000 UUID in passIds e "format": "csv"):

HTTP
POST /api/v1/passes/export HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "passIds": [
    "55a19c88-102b-4f33-8d99-ccddff001122",
    "77b20d99-304c-4a11-9e00-112233445566"
  ],
  "format": "csv"
}

Header di risposta e CSV in streaming (200 OK)

HTTP
HTTP/1.1 200 OK
Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="passes-export.csv"
CSV
id,serialNumber,externalId,status,walletPlatform,activeRegistrations,firstName,email,tier,pointsBalance,createdAt
55a19c88-102b-4f33-8d99-ccddff001122,PI-2026-994812,CRM-88210,ACTIVE,APPLE_WALLET,2,Elena,elena@example.com,GOLD,1450,2026-10-14T09:15:22.000Z
77b20d99-304c-4a11-9e00-112233445566,PI-2026-994815,CRM-88219,ACTIVE,GOOGLE_WALLET,1,Marcus,marcus@example.com,GOLD,980,2026-10-18T14:40:05.000Z

2. Esportazioni CSV dell'audit trail scansioni e dell'audit log di sicurezza

Esporti gli esiti di scansione o i log di audit amministrativo per verifiche di conformità e riconciliazione finanziaria:

HTTP
GET /api/v1/validation/scan-results/export/csv?startDate=2026-11-01T00:00:00.000Z&endDate=2026-11-16T23:59:59.999Z&decision=SUCCESS HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
HTTP
GET /api/v1/audit-log/export.csv?startDate=2026-11-01T00:00:00.000Z&endDate=2026-11-16T23:59:59.999Z HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

3. Esportazione portabilità interessato GDPR (request payload)

Quando un titolare del pass presenta una richiesta verificata di accesso ai dati (DSAR), trasmetta a Privacy Compliance API una singola stringa di ricerca query da 3–256 caratteri (come indirizzo e-mail, numero seriale o externalId):

HTTP
POST /api/v1/customer/cus_89a12b34-56c7-4d89-9e01-23456789abcd/privacy-settings/data-subject-export HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "query": "elena@example.com"
}
JSON
{
  "exportedAt": "2026-11-16T10:34:10.000Z",
  "workspaceId": "cus_89a12b34-56c7-4d89-9e01-23456789abcd",
  "queryLength": 17,
  "totalCount": 2,
  "groups": [
    {
      "resourceType": "passes",
      "items": [
        {
          "id": "55a19c88-102b-4f33-8d99-ccddff001122",
          "identifier": "PI-2026-994812",
          "createdAt": "2026-10-14T09:15:22.000Z",
          "updatedAt": "2026-11-16T08:42:11.000Z",
          "source": "api",
          "processingPurpose": "loyalty_program",
          "retentionStatus": "ACTIVE",
          "relatedResourceIds": ["scn_019331f4-8e2a-7b00-9c11-44a8e2019b3c"]
        }
      ]
    }
  ]
}

Documentazione correlata

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.