Ruta del menú: Panel > Archivos

Archivos

Resumen

Archivos es la página donde puede descargar por fecha los datos de Producción con más de 30 días. Es útil para análisis, copias de seguridad y para mover los datos a sistemas externos.

Política de archivado

Solo el entorno de Producción. Los datos de Sandbox no se archivan y se eliminan automáticamente después de 30 días
Los datos de Producción se conservan de forma permanente mientras su cuenta esté activa, y pueden consultarse en cualquier momento en la página de Registros
Los datos de Producción con más de 30 días se archivan automáticamente y pueden descargarse por fecha desde esta página
Los archivos se crean con una frecuencia diaria
Se ofrecen dos formatos de descarga: JSONL (.jsonl.gz) o CSV
Listos para el análisis con pandas, DuckDB, jq, Jupyter y más

Cómo llegar aquí

Menú superior Archivos → Seleccione un endpoint de la lista para descargarlo

Lista de endpoints

Lista de endpoints de archivos

En la parte superior de la página se muestra una tarjeta informativa que resume la política de retención y los formatos de archivo. Debajo, el acordeón Ver esquema de datos puede expandirse para previsualizar la estructura de campos del archivo (el mismo contenido que la sección "Esquema del archivo de datos" más abajo).

Debajo, una tabla enumera los endpoints con datos archivados.

Columna	Descripción
Endpoint	Nombre del endpoint
Archivos	Número de archivos (diarios)
Tamaño total	Tamaño combinado de todos los archivos
Rango de fechas	De la fecha más antigua a la más reciente
Más reciente	Fecha del archivo más reciente

Haga clic en un endpoint para ir a la página de lista de archivos.

Lista de archivos

Detalle de archivo

Al seleccionar un endpoint, se muestran sus archivos diarios.

Columna	Descripción
Fecha	Fecha objetivo del archivo (UTC)
Registros	Número de llamadas API registradas ese día
Tamaño del archivo	Tamaño del archivo JSONL.gz comprimido
Descargar	Botones `JSONL` / `CSV`

Dos formatos de descarga

JSONL (`.jsonl.gz`)

Registros de producción diarios comprimidos con gzip
Un registro JSON por línea
Se conserva en el formato original — adecuado para el análisis programático, copias de seguridad y reprocesamiento

Ejemplo:

{"id":"rec_...","payload":{"order_id":"ORD-001"},"status":"success","created_at":"..."}
{"id":"rec_...","payload":{"order_id":"ORD-002"},"status":"success","created_at":"..."}

CSV (`.csv`)

Formato apto para hojas de cálculo
Los campos del sistema van primero, seguidos por los campos de negocio aplanados con prefijo payload_
Ejemplo: payload.customer.name → payload_customer_name
Se abre inmediatamente en Excel, Google Sheets, etc.
Nota: La conversión a CSV puede tardar dependiendo del tamaño del archivo y solo funciona en navegadores de PC (debido al procesamiento de archivos grandes)

Esquema del archivo de datos

Estructura de campos de cada registro dentro de un archivo descargado. Cada línea del JSONL es un registro. En el CSV, los campos del sistema van primero, seguidos por los campos de negocio aplanados con prefijo payload_.

Campo	Descripción
`id`	ID del registro
`payload`	Datos de negocio (JSON)
`config_version`	Versión del esquema
`status`	Resultado del procesamiento (`success` / `failed`)
`error_details`	Detalles del error (en caso de fallo)
`created_at`	Hora de creación
`updated_at`	Hora de actualización
`endpoint_name`	Nombre del endpoint
`endpoint_slug`	Ruta URL del endpoint
`collaboration_key_name`	Nombre de la clave del llamador
`gateway_processing_time_ms`	Tiempo de procesamiento (ms)

Solución de problemas

La lista de archivos está vacía: Los datos de Producción deben tener más de 30 días para ser archivados. Consulte la página de Registros para ver los datos más recientes
La descarga de CSV no funciona en móvil: La conversión a CSV requiere un procesamiento intensivo y es solo para navegadores de PC. El JSONL sí puede descargarse desde el móvil
Los caracteres no ingleses se ven corruptos al abrir el CSV en una hoja de cálculo: Los archivos CSV están codificados en UTF-8. Especifique UTF-8 como codificación de caracteres al abrirlos en su hoja de cálculo para evitar caracteres corruptos
¿Puedo descargar archivos en el plan Free?: El archivado es una función de los planes de pago. Los endpoints del plan Free se eliminan automáticamente 7 días después de su creación, por lo que no se necesitan archivos

Estadísticas

Perfil