Skip to content
Helpcentrum-gids
3 min leestijdGecontroleerd 2026-11-16

Gegevensexports & rapportage

Exporteer gefilterde lijsten als CSV-download, geplande FTP/SFTP-upload of geautomatiseerde API-rapportage.

In deze gids

Overzicht

Passinstance biedt streaming eindpunten voor gegevensexport over elk operationeel kerndomein — waaronder pasinstanties (POST /api/v1/passes/export), geschiedenissen van validatiescans, apparaatsleutels van scanners, zakelijke dashboardrapporten, btw-facturen, AVG-archieven voor betrokkenen en compliance-auditlogboeken (GET /api/v1/audit-log/export.csv of in het Dashboard op /settings/workspace/developer/audit-logs). Alle exporten zijn strikt afgebakend tot uw geauthenticeerde werkruimte (Customer) en worden gestreamd met standaard MIME-headers voor directe verwerking door spreadsheetsoftware, ERP-pijplijnen of SIEM-systemen.

Architectuur voor gegevensexport over meerdere domeinen

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
SYSTEEMARCHITECTUURSTROOM: STREAMING GEGEVENSEXPORT & COMPLIANCE-ENGINE
FASE 01 AANVRAAGLAAG VOOR CLIENTS & AUTOMATISERING
Dashboard Export-UI
(Gefilterde tabellen)
Geplande BI- / ERP-taak
(x-api-key / Bearer)
Compliance & Jurid.
(AVG-DSR & Audit)
FASE 02 PASSINSTANCE EXPORTCONTROLLERS (API)
Operationele exporten (UTF-8 CSV)
POST/api/v1/passes/export
GET/api/v1/validation/scans/*
GET/api/v1/dashboards/export
Financiële & compliance-exporten
GET/api/v1/billing/invoices/*
POST .../data-subject-export
GET/api/v1/audit-log/export.csv
FASE 03 UITVOERFORMATEN & BESTEMMINGEN
text/csv; charset=utf8
RFC 4180-geëscapete rij (Passen, Scans, Keys)
application/pdf
Gespecificeerde factuur
& Dashboardsnapshots
application/json
AVG-archieven &
Dashboard-JSON

Belangrijk: Geëxporteerde CSV- en JSON-bestanden bevatten vaak persoonsgegevens (PII) van pashouders, zoals namen, e-mailadressen, externalId-waarden en transactiegeschiedenissen. Bewaar en verwijder gedownloade exportbestanden altijd in overeenstemming met het bewaarbeleid van uw organisatie onder Gegevensprivacy en AVG.

Volledige catalogus van exporteindpunten

Pasinstanties
POST
Eindpuntpad
/api/v1/passes/export
Uitvoerformaten (Content-Type)
text/csv; charset=utf-8
Beschrijving
Streamt CSV-rijen (passes-export.csv) voor een expliciete lijst van maximaal 2000 UUID's (request payload: { passIds, format: "csv" }).
Scangeschiedenis per config
GET
Eindpuntpad
/api/v1/validation/configs/:id/scans/export
Uitvoerformaten (Content-Type)
text/csv; charset=utf-8
Beschrijving
Exporteert scangebeurtenissen en verzilveringen van mechanieken voor één specifieke ScannerConfiguration.
Werkruimtescans
GET
Eindpuntpad
/api/v1/validation/scans/export
Uitvoerformaten (Content-Type)
text/csv; charset=utf-8
Beschrijving
Exporteert de werkruimtebrede geschiedenis van validatiescans over alle configuraties heen.
Scanaudittrail
GET
Eindpuntpad
/api/v1/validation/scan-results/export/csv
Uitvoerformaten (Content-Type)
text/csv; charset=utf-8
Beschrijving
Volledige gedetailleerde audittrail van scanresultaten inclusief decision, reasonCode, operator-ID en saldo-effecten.
Apparaatsleutels voor scanners
GET
Eindpuntpad
/api/v1/validation/configs/:id/scanner-keys/export/csv
Uitvoerformaten (Content-Type)
text/csv; charset=utf-8
Beschrijving
Inventaris van uitgegeven scannersleutels, koppelingsstatussen, vervaldatums en metadata van apparaattelemetrie.
Dashboardoverzicht
GET
Eindpuntpad
`/api/v1/dashboards/export?format=csv\
HTTP-werkwoord
json\
Uitvoerformaten (Content-Type)
pdf`
Uitvoer van batchtaken
GET
Eindpuntpad
/api/v1/batch-processing/:id/result.csv
Uitvoerformaten (Content-Type)
text/csv; charset=utf-8
Beschrijving
Downloadt verwerkte uitvoerrijen van een asynchrone batchtaak voor aanmaken of bijwerken.
Factureringsfacturen
GET
Eindpuntpad
/api/v1/billing/invoices/:id/download
Uitvoerformaten (Content-Type)
application/pdf
Beschrijving
Streamt de officiële gespecificeerde btw-factuur als PDF voor een specifieke factureringscyclus.
AVG-betrokkene
POST
Eindpuntpad
/api/v1/customer/:customerId/privacy-settings/data-subject-export
Uitvoerformaten (Content-Type)
application/json
Beschrijving
Genereert een gestructureerde AVG-payload voor gegevensoverdraagbaarheid conform artikel 15/20 (IDataSubjectExportPayload) op basis van request payload.query.
Beveiligingsauditlogboek
GET
Eindpuntpad
/api/v1/audit-log/export.csv
Uitvoerformaten (Content-Type)
text/csv; charset=utf-8
Beschrijving
Exporteert maximaal 1000 onveranderlijke rijen met beheerdersactiviteiten (ondersteunt action, entityType, userId, startDate, endDate, customerId).

Voorbeelden van API-gebruik

1. CSV-export van pasinstanties (POST /api/v1/passes/export)

Vraag overeenkomende pas-UUID's op via GET /api/v1/passes of POST /api/v1/passes/query-builder en stream ze vervolgens als passes-export.csv via POST /api/v1/passes/export (request payload vereist 1–2.000 UUID's in passIds en "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"
}

Antwoordheaders en gestreamde CSV (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-exporten van scanaudittrail en beveiligingsauditlogboek

Exporteer scanresultaten of administratieve audittrails voor compliance en financiële afstemming:

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. AVG-overdraagbaarheidsexport voor betrokkenen (request payload)

Wanneer een pashouder een geverifieerd inzageverzoek (DSAR) indient, geeft u één enkele zoekopdracht query van 3–256 tekens (zoals e-mailadres, serienummer of externalId) door aan 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"]
        }
      ]
    }
  ]
}

Gerelateerde documentatie

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.