Skip to content
Guide du centre d'aide
4 min de lectureVérifié 2026-11-16

Exports de données & reporting

Exportez vos listes filtrées par CSV manuel, synchronisation automatique FTP/SFTP ou requêtes REST planifiées.

Dans ce guide

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

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : EXPORTATION EN CONTINU ET MOTEUR DE CONFORMITÉ
ÉTAPE 01 COUCHE DE REQUÊTE CLIENT ET AUTOMATISATION
Interface d'export UI
(Vues tableaux filtrés)
Tâche BI / ERP planif.
(x-api-key / Bearer)
Conformité & Légal
(DSR RGPD & Audit)
ÉTAPE 02 CONTRÔLEURS D'EXPORTATION PASSINSTANCE (API)
Exportations opérationnelles (CSV)
POST/api/v1/passes/export
GET/api/v1/validation/scans/*
GET/api/v1/dashboards/export
Exportations financières/conformité
GET/api/v1/billing/invoices/*
POST .../data-subject-export
GET/api/v1/audit-log/export.csv
ÉTAPE 03 FORMATS DE SORTIE ET DESTINATIONS
text/csv; charset=utf8
Lignes échappées RFC (Passes, Scans, Clés)
application/pdf
Factures fiscales déta. et instantanés de bord
application/json
Archives RGPD &
JSON tableau de bord

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 externalId et 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

Instances de passes
POST
Chemin du point de terminaison
/api/v1/passes/export
Formats de sortie (Content-Type)
text/csv; charset=utf-8
Description
Diffuse des lignes CSV (passes-export.csv) pour une liste explicite allant jusqu'à 2000 UUID (request payload : { passIds, format: "csv" }).
Historique de scans par config
GET
Chemin du point de terminaison
/api/v1/validation/configs/:id/scans/export
Formats de sortie (Content-Type)
text/csv; charset=utf-8
Description
Exporte les événements de scan et les échanges de mécaniques rattachés à une seule ScannerConfiguration.
Scans de l'espace de travail
GET
Chemin du point de terminaison
/api/v1/validation/scans/export
Formats de sortie (Content-Type)
text/csv; charset=utf-8
Description
Exporte l'historique des scans de validation à l'échelle de l'espace de travail sur toutes les configurations.
Piste d'audit des scans
GET
Chemin du point de terminaison
/api/v1/validation/scan-results/export/csv
Formats de sortie (Content-Type)
text/csv; charset=utf-8
Description
Piste d'audit granulaire complète des résultats de scan incluant decision, reasonCode, l'ID d'opérateur et les effets sur le solde.
Clés d'appareils de scan
GET
Chemin du point de terminaison
/api/v1/validation/configs/:id/scanner-keys/export/csv
Formats de sortie (Content-Type)
text/csv; charset=utf-8
Description
Inventaire des clés de scanner émises, statuts de jumelage, dates d'expiration et métadonnées de télémétrie des appareils.
Synthèse du tableau de bord
GET
Chemin du point de terminaison
`/api/v1/dashboards/export?format=csv\
Verbe HTTP
json\
Formats de sortie (Content-Type)
pdf`
Résultat de traitement par lot
GET
Chemin du point de terminaison
/api/v1/batch-processing/:id/result.csv
Formats de sortie (Content-Type)
text/csv; charset=utf-8
Description
Télécharge les lignes de sortie traitées issues d'une tâche asynchrone de création ou de mise à jour par lot.
Factures d'abonnement
GET
Chemin du point de terminaison
/api/v1/billing/invoices/:id/download
Formats de sortie (Content-Type)
application/pdf
Description
Diffuse le PDF officiel de la facture fiscale/TVA détaillée pour un cycle de facturation spécifique.
Personne concernée RGPD
POST
Chemin du point de terminaison
/api/v1/customer/:customerId/privacy-settings/data-subject-export
Formats de sortie (Content-Type)
application/json
Description
Génère une charge utile structurée de portabilité au titre des articles 15/20 du RGPD (IDataSubjectExportPayload) correspondant à request payload.query.
Journal d'audit de sécurité
GET
Chemin du point de terminaison
/api/v1/audit-log/export.csv
Formats de sortie (Content-Type)
text/csv; charset=utf-8
Description
Exporte jusqu'à 1000 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") :

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

En-têtes de réponse et flux 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. 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 :

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. 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 :

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

Documentation connexe

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.