Skip to content
Hilfecenter-Anleitung
3 Min. LesezeitGeprüft 2026-11-16

Datenexporte & Reporting

Exportieren Sie gefilterte Passlisten per CSV-Download, automatisiertem FTP/SFTP-Upload oder Reporting-API.

In dieser Anleitung

Übersicht

Passinstance stellt Streaming-Datenexport-Endpunkte für alle wichtigen operativen Bereiche bereit – darunter Karteninstanzen (POST /api/v1/passes/export), Validierungs-Scanhistorien, Scanner-Geräteschlüssel, Management-Dashboard-Berichte, USt.-Steuerrechnungen, DSGVO-Archive für betroffene Personen sowie Compliance-Audit-Protokolle (GET /api/v1/audit-log/export.csv oder im Dashboard unter /settings/workspace/developer/audit-logs). Alle Exporte sind strikt auf Ihren authentifizierten Workspace (Customer) begrenzt und werden mit standardmäßigen MIME-Headern gestreamt, sodass sie sofort in Tabellenkalkulationsprogrammen, ERP-Pipelines oder SIEM-Systemen weiterverarbeitet werden können.

Bereichsübergreifende Datenexport-Architektur

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
STREAMING-DATENEXPORT- & COMPLIANCE-ENGINE
STUFE 01 CLIENT- & AUTOMATISIERUNGS-ANFRAGESCHICHT
Dashboard-Export-UI
(Gefilterte Tabellen)
Geplanter BI-/ERP-Job
(x-api-key / Bearer)
Compliance & Recht
(DSGVO-DSR & Audit)
STUFE 02 PASSINSTANCE EXPORT-CONTROLLER (API)
Operative Exporte (UTF-8-CSV)
POST/api/v1/passes/export
GET/api/v1/validation/scans/*
GET/api/v1/dashboards/export
Finanz- & Compliance-Exporte
GET/api/v1/billing/invoices/*
POST .../data-subject-export
GET/api/v1/audit-log/export.csv
STUFE 03 AUSGABEFORMATE & ZIELSYSTEME
text/csv; charset=utf8
RFC 4180 Escaped Rows (Karten, Scans, Keys)
application/pdf
Einzelposten-Rechnung
& Dashboard-Snapshots
application/json
DSGVO-Archive &
Dashboard-JSON

Wichtig: Exportierte CSV- und JSON-Dateien enthalten häufig personenbezogene Daten (PII) von Karteninhabern wie Namen, E-Mail-Adressen, externalId-Werte und Transaktionsverläufe. Speichern und löschen Sie heruntergeladene Exporte stets im Einklang mit den Aufbewahrungsrichtlinien Ihrer Organisation gemäß Datenschutz & DSGVO.

Vollständiger Katalog der Export-Endpunkte

Karteninstanzen
POST
Endpunktpfad
/api/v1/passes/export
Ausgabeformate (Content-Type)
text/csv; charset=utf-8
Beschreibung
Streamt CSV-Zeilen (passes-export.csv) für eine explizite Liste von bis zu 2000 UUIDs (request payload: { passIds, format: "csv" }).
Konfigurations-Scanhistorie
GET
Endpunktpfad
/api/v1/validation/configs/:id/scans/export
Ausgabeformate (Content-Type)
text/csv; charset=utf-8
Beschreibung
Exportiert Scan-Ereignisse und Mechanik-Einlösungen, die auf eine einzelne ScannerConfiguration begrenzt sind.
Workspace-Scans
GET
Endpunktpfad
/api/v1/validation/scans/export
Ausgabeformate (Content-Type)
text/csv; charset=utf-8
Beschreibung
Exportiert die workspace-weite Validierungs-Scanhistorie über alle Konfigurationen hinweg.
Scan-Audit-Trail
GET
Endpunktpfad
/api/v1/validation/scan-results/export/csv
Ausgabeformate (Content-Type)
text/csv; charset=utf-8
Beschreibung
Vollständiger granularer Audit-Trail der Scan-Ergebnisse einschließlich decision, reasonCode, Bediener-ID und Auswirkungen auf den Kontostand.
Scanner-Geräteschlüssel
GET
Endpunktpfad
/api/v1/validation/configs/:id/scanner-keys/export/csv
Ausgabeformate (Content-Type)
text/csv; charset=utf-8
Beschreibung
Bestandsliste ausgestellter Scannerschlüssel, Kopplungsstatus, Ablaufdaten und Geräte-Telemetriemetadaten.
Dashboard-Zusammenfassung
GET
Endpunktpfad
`/api/v1/dashboards/export?format=csv\
HTTP-Verb
json\
Ausgabeformate (Content-Type)
pdf`
Batch-Job-Ergebnis
GET
Endpunktpfad
/api/v1/batch-processing/:id/result.csv
Ausgabeformate (Content-Type)
text/csv; charset=utf-8
Beschreibung
Lädt verarbeitete Ausgabezeilen eines asynchronen Batch-Erstellungs- oder Aktualisierungs-Jobs herunter.
Abrechnungsrechnungen
GET
Endpunktpfad
/api/v1/billing/invoices/:id/download
Ausgabeformate (Content-Type)
application/pdf
Beschreibung
Streamt die offizielle, nach Einzelposten aufgeschlüsselte Steuer-/USt.-Rechnung als PDF für einen bestimmten Abrechnungszeitraum.
DSGVO-Betroffenenauskunft
POST
Endpunktpfad
/api/v1/customer/:customerId/privacy-settings/data-subject-export
Ausgabeformate (Content-Type)
application/json
Beschreibung
Generiert ein strukturiertes Datenübertragbarkeits-Payload gemäß Art. 15/20 DSGVO (IDataSubjectExportPayload) passend zu request payload.query.
Sicherheits-Audit-Protokoll
GET
Endpunktpfad
/api/v1/audit-log/export.csv
Ausgabeformate (Content-Type)
text/csv; charset=utf-8
Beschreibung
Exportiert bis zu 1000 unveränderliche Zeilen zu administrativen Aktivitäten (unterstützt action, entityType, userId, startDate, endDate, customerId).

API-Anwendungsbeispiele

1. CSV-Export von Karteninstanzen (POST /api/v1/passes/export)

Fragen Sie passende Karten-UUIDs über GET /api/v1/passes oder POST /api/v1/passes/query-builder ab und streamen Sie diese anschließend als passes-export.csv über POST /api/v1/passes/export (request payload erfordert 1–2.000 UUIDs in passIds sowie "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"
}

Antwort-Header & gestreamte CSV-Datei (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. CSV-Exporte für Scan-Audit-Trails & Sicherheits-Audit-Protokolle

Exportieren Sie Scan-Ergebnisse oder administrative Audit-Trails für Compliance-Prüfungen und Finanzabstimmungen:

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. DSGVO-Datenübertragbarkeitsexport für betroffene Personen (request payload)

Wenn ein Karteninhaber einen verifizierten Auskunftsantrag (DSAR) stellt, übergeben Sie eine einzelne Suchanfrage query (3–256 Zeichen, z. B. E-Mail-Adresse, Seriennummer oder externalId) an den Privacy Compliance API:

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"]
        }
      ]
    }
  ]
}

Weiterführende Dokumentation

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.