Descripción General
Passinstance ofrece endpoints de exportación de datos por transmisión en cada dominio operativo principal, incluidas las instancias de pases (POST /api/v1/passes/export), historiales de escaneo de validación, claves de dispositivos de escáner, informes ejecutivos del panel, facturas fiscales con IVA, archivos de interesados del RGPD y registros de auditoría de cumplimiento (GET /api/v1/audit-log/export.csv o en el Panel en /settings/workspace/developer/audit-logs). Todas las exportaciones están estrictamente delimitadas a su espacio de trabajo autenticado (Customer) y se transmiten con encabezados MIME estándar para su consumo inmediato por software de hojas de cálculo, canalizaciones ERP o sistemas SIEM.
Arquitectura de Exportación de Datos Multidominio
Importante: Los archivos CSV y JSON exportados suelen contener Información de Identificación Personal (PII) de los titulares de pases, como nombres, direcciones de correo electrónico, valores
externalIde historiales de transacciones. Almacene y depure siempre las exportaciones descargadas de acuerdo con las políticas de retención de Privacidad de Datos y RGPD de su organización.
Catálogo Completo de Endpoints de Exportación
/api/v1/passes/exportContent-Type)text/csv; charset=utf-8passes-export.csv) para una lista explícita de hasta 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, ID de operador y efectos en el saldo./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) que coincide con request payload.query./api/v1/audit-log/export.csvContent-Type)text/csv; charset=utf-81000 filas de actividad administrativa inmutable (admite action, entityType, userId, startDate, endDate, customerId).Ejemplos de Uso de la API
1. Exportación CSV de Instancias de Pases (POST /api/v1/passes/export)
Consulte los UUID de los pases coincidentes mediante GET /api/v1/passes o POST /api/v1/passes/query-builder y, a continuación, transmítalos como passes-export.csv mediante POST /api/v1/passes/export (request payload requiere entre 1 y 2,000 UUID en passIds y "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"
}
Encabezados de Respuesta y CSV Transmitido (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. Exportaciones CSV del Registro de Auditoría de Escaneos y del Registro de Auditoría de Seguridad
Exporte los resultados de escaneo o los registros de auditoría administrativa para el cumplimiento normativo y la conciliación financiera:
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. Exportación de Portabilidad del Interesado según el RGPD (request payload)
Cuando un titular de pase envía una Solicitud de Acceso del Interesado (DSAR) verificada, pase una única consulta query de búsqueda de 3 a 256 caracteres (como dirección de correo electrónico, número de serie o externalId) a 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"]
}
]
}
]
}
Documentación Relacionada
-
Revise los códigos de decisión de escaneo en Informes de Escaneo y Canje.
-
Descargue facturas fiscales en Facturas e Historial de Facturación.
-
Obtenga más información sobre la retención y supresión automatizada de datos en Privacidad de Datos y RGPD.
