Présentation
Passinstance fournit des points de terminaison d'exportation de données en flux continu sur l'ensemble des domaines opérationnels clés — notamment les instances de passes (POST /api/v1/passes/export), les historiques de scans de validation, les clés d'appareils de scan, les rapports exécutifs du tableau de bord, les factures fiscales de TVA, les archives RGPD des personnes concernées et les journaux d'audit de conformité (GET /api/v1/audit-log/export.csv ou dans le tableau de bord sous /settings/workspace/developer/audit-logs). Toutes les exportations sont strictement rattachées à votre espace de travail authentifié (Customer) et diffusées avec des en-têtes MIME standard pour une exploitation immédiate par des tableurs, des pipelines ERP ou des outils SIEM.
Architecture d'exportation de données multi-domaines
Important : Les fichiers CSV et JSON exportés contiennent fréquemment des données à caractère personnel (PII) relatives aux détenteurs de passes, telles que les noms, adresses e-mail, valeurs
externalIdet historiques de transactions. Stockez et purgez toujours les exportations téléchargées conformément aux politiques de conservation de votre organisation définies dans Confidentialité des données et RGPD.
Catalogue complet des points de terminaison d'exportation
/api/v1/passes/exportContent-Type)text/csv; charset=utf-8passes-export.csv) pour une liste explicite allant jusqu'à 2000 UUID (request payload : { passIds, format: "csv" })./api/v1/validation/configs/:id/scans/exportContent-Type)text/csv; charset=utf-8ScannerConfiguration./api/v1/validation/scans/exportContent-Type)text/csv; charset=utf-8/api/v1/validation/scan-results/export/csvContent-Type)text/csv; charset=utf-8decision, reasonCode, l'ID d'opérateur et les effets sur le solde./api/v1/validation/configs/:id/scanner-keys/export/csvContent-Type)text/csv; charset=utf-8Content-Type)/api/v1/batch-processing/:id/result.csvContent-Type)text/csv; charset=utf-8/api/v1/billing/invoices/:id/downloadContent-Type)application/pdf/api/v1/customer/:customerId/privacy-settings/data-subject-exportContent-Type)application/jsonIDataSubjectExportPayload) correspondant à request payload.query./api/v1/audit-log/export.csvContent-Type)text/csv; charset=utf-81000 lignes immuables d'activité administrative (prend en charge action, entityType, userId, startDate, endDate, customerId).Exemples d'utilisation de l'API
1. Exportation CSV des instances de passes (POST /api/v1/passes/export)
Recherchez les UUID des passes correspondants via GET /api/v1/passes ou POST /api/v1/passes/query-builder, puis diffusez-les sous forme de fichier passes-export.csv via POST /api/v1/passes/export (request payload requiert de 1 à 2 000 UUID dans passIds ainsi que "format": "csv") :
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"
}
En-têtes de réponse et flux CSV (200 OK)
HTTP/1.1 200 OK
Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="passes-export.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. Exportations CSV de la piste d'audit des scans et du journal d'audit de sécurité
Exportez les résultats de scan ou les pistes d'audit administratives à des fins de conformité et de rapprochement financier :
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>
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. Exportation de portabilité RGPD pour une personne concernée (request payload)
Lorsqu'un détenteur de pass soumet une demande vérifiée d'accès aux données (DSAR), transmettez une chaîne de recherche query unique de 3 à 256 caractères (telle qu'une adresse e-mail, un numéro de série ou un externalId) à Privacy Compliance API :
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"
}
{
"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"]
}
]
}
]
}
Documentation connexe
-
Consultez les codes de décision de scan dans Rapports de scan et d'échange.
-
Téléchargez vos factures fiscales dans Factures et historique de facturation.
-
Découvrez la conservation automatisée et l'effacement des données dans Confidentialité des données et RGPD.
