Exportación de datos del espacio de trabajo
Exporte un espacio de trabajo completo como un archivo JSON. Un administrador del espacio de trabajo lo solicita desde Cuenta → Datos y exportación en la aplicación, o a través del API a continuación: se ejecuta como un trabajo asíncrono, se descarga a través de un enlace firmado de corta duración y conduce con un manifiesto de cobertura para que pueda verificar que esté completo. Se excluyen los secretos y se audita cada solicitud.
La forma de ello
Solo para administradores.
Los puntos de exportación requieren un administrador del espacio de trabajo. Abarcan todo el espacio de trabajo, por lo que su acceso está restringido al rol que tiene permiso para verlo en su totalidad.
Diseño asíncrono
Una solicitud pone en cola un proceso en segundo plano que ensambla el archivo, de modo que un espacio de trabajo grande nunca se bloquea por una sola solicitud HTTP. Se consulta el estado y luego se descarga.
Descarga firmada y de corta duración.
El archivo final se obtiene mediante un enlace firmado que caduca poco después de su publicación; no es una URL pública ni permanente.
Auditado de principio a fin
Cada solicitud de exportación y cada descarga se registra en el historial de auditoría, por lo que siempre queda constancia de quién exportó qué y cuándo.
Solicitar una exportación
Un punto final exclusivo de administrador inicia un trabajo en segundo plano. Regresa inmediatamente con una identificación del trabajo; el archivo se reúne detrás de escena.
// Kick off a full-workspace export. Requires a workspace ADMIN session (org owner/admin).
// The whole export is scoped to the caller's own workspace (tenant-isolated).
POST https://flash.socialhub.ai/api/flash/account/data-export
// → { data: { id: "<jobId>", status: "pending", deduped: false } }
// The archive is assembled in the background — this returns immediately. If an
// export is already pending/running, the same job is returned (deduped: true).Encuesta, luego descarga
// Poll for status, then download when it's ready.
GET https://flash.socialhub.ai/api/flash/account/data-export
// → { data: {
// jobs: [ { id, status, rowCount, createdAt, completedAt, error } ],
// dataHandling: { summary, facts: [ ... ] } // the honest data-handling notes
// } }
// status is one of: "pending" | "running" | "completed" | "failed"
//
// When a job is "completed", fetch a short-lived signed download link:
GET https://flash.socialhub.ai/api/flash/exports/{id}/download
// → { data: { url: "<short-lived signed link>" } }
// Download the archive before the link expires; re-request to get a fresh one.El manifiesto de cobertura
El archivo es un documento JSON que se abre con un manifiesto de cada sección incluida y su recuento de registros, por lo que la integridad es verificable, no supuesta. Los nombres de los campos a continuación son ilustrativos de la forma del manifiesto.
// The archive is a single JSON document that LEADS with a coverage manifest:
// exactly which sections are included and how many records are in each. Large
// sections are capped for a manageable export — the manifest flags where a cap applied.
{
"manifest": {
"generatedAt": "<timestamp>",
"sections": [
{ "name": "members", "recordCount": <n>, "capped": <bool> },
{ "name": "orders", "recordCount": <n>, "capped": <bool> },
{ "name": "campaigns", "recordCount": <n>, "capped": <bool> }
// …one entry per included section
]
},
// …the section payloads follow.
}Exportaciones operativas y programadas
Además del archivo completo del espacio de trabajo, un administrador puede exportar las tablas members o orders de forma independiente —en formato CSV o JSONL, una sola vez o con una periodicidad diaria/semanal— y, opcionalmente, enviar cada ejecución a su almacén de datos mediante un webhook firmado. Mismo control de acceso para el administrador, trabajo asíncrono, descarga firmada y registro de auditoría; con un límite para una extracción manejable.
// Operational export of a single entity — admin-only, async, same signed-link download.
// Choose CSV or JSONL, and optionally have Flash push the finished file to your warehouse.
POST https://flash.socialhub.ai/api/flash/exports
{
"entity": "members", // "members" | "orders"
"format": "csv", // "csv" | "jsonl"
"webhookUrl": "https://..." // optional reverse-ETL: your loader is notified with a
// short-lived signed link when the run completes (HTTPS only)
}
// → { data: { id: "<jobId>", status: "pending" } } // poll + download like the workspace export
// Capped at ~200k rows per run. Configure daily/weekly schedules from Account → Data & Export.Qué cubre el archivo
La exportación abarca todo el espacio de trabajo. Las secciones grandes tienen límites para una descarga manejable, y el manifiesto indica dónde se aplicó un límite.
Los secretos están excluidos
API Las claves, credenciales y tokens se excluyen deliberadamente del archivo. La portabilidad de datos nunca implica exportar las claves a sus integraciones.
Cómo se manejan los datos
Nube administrada, región única
La plataforma se ejecuta en una infraestructura de nube administrada en una sola región.
Cifrado en tránsito y en reposo
TLS en la transmisión y AES-256 en reposo, incluidos los propios archivos de exportación.
Copias de seguridad de bases de datos gestionadas
La base de datos administrada tiene copias de seguridad, por lo que los datos subyacentes son duraderos.
Subprocesadores publicados
Los subprocesadores de infraestructura se enumeran en la página de confianza, con aviso antes de que cambien.
Para conocer los estándares que debemos cumplir y cómo apoyamos sus obligaciones de cumplimiento, consulte la descripción general de Cumplimiento de datos y la guía para desarrolladores de Seguridad de datos.
¿Creando un flujo de exportación?
Hable con un ingeniero sobre el trabajo de exportación del administrador, la descarga firmada, el manifiesto de cobertura o la exportación del sujeto de datos por miembro.
hablar con ingenieria