Exportation des données de l'espace de travail
Exportez un espace de travail entier sous forme d’une seule archive JSON. Un administrateur d'espace de travail le demande depuis Compte → Données et exportation dans l'application, ou via le API ci-dessous : il s'exécute comme une tâche asynchrone, est téléchargé via un lien signé de courte durée et mène avec un manifeste de couverture afin que vous puissiez vérifier l'exhaustivité. Les secrets sont exclus et chaque demande est auditée.
Structure
Réservé à l'administrateur.
Les points de terminaison d'exportation nécessitent un administrateur d'espace de travail. Ils couvrent l'intégralité de l'espace de travail et sont donc réservés au rôle autorisé à le consulter intégralement.
Conception asynchrone
Une requête lance une tâche en arrière-plan qui assemble l'archive, évitant ainsi qu'un espace de travail volumineux ne soit bloqué par une seule requête HTTP. Vous interrogez l'état d'avancement, puis vous téléchargez.
Téléchargement signé et de courte durée
L'archive finale est accessible via un lien signé qui expire peu après sa publication – et non via une URL publique ou permanente.
Audit de bout en bout
Chaque demande d’exportation et chaque téléchargement est enregistré dans l’historique des modifications. Ainsi, l’historique des exportations est toujours disponible.
Demander une exportation
Un point de terminaison réservé aux administrateurs démarre une tâche en arrière-plan. Il revient immédiatement avec un identifiant de travail ; les archives sont rassemblées en coulisses.
// 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).Sondez, puis téléchargez
// 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.Manifeste de couverture
L'archive est un document JSON qui s'ouvre avec un manifeste de chaque section incluse et son nombre d'enregistrements — donc l'exhaustivité est vérifiable et non supposée. Les noms de champs ci-dessous illustrent la forme du manifeste.
// 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.
}Exportations opérationnelles et planifiées
Outre l'archivage complet de l'espace de travail, un administrateur peut exporter séparément les tables members ou orders (au format CSV ou JSONL, ponctuellement ou de façon régulière, quotidiennement ou hebdomadairement). Il peut également configurer l'envoi de chaque exécution vers votre entrepôt de données via un webhook signé. Les mêmes mécanismes de contrôle d'accès, la même tâche asynchrone, le même téléchargement signé et le même journal d'audit sont appliqués, avec une limite pour une extraction gérable.
// 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.Ce que couvrent les archives
L’exportation couvre l’ensemble de l’espace de travail. Les sections importantes sont limitées pour un téléchargement plus facile, et le manifeste indique les limites appliquées.
Les secrets sont exclus
API Les clés, identifiants et jetons sont volontairement exclus de l’archive. La portabilité des données n’implique jamais l’exportation des clés vers vos intégrations.
Gestion des données
Cloud géré, région unique
La plateforme fonctionne sur une infrastructure cloud gérée dans une seule région.
Chiffrement en transit et au repos
TLS en transit et AES-256 au repos, y compris pour les fichiers d'archive d'exportation.
Sauvegardes de bases de données gérées
La base de données gérée est sauvegardée, garantissant ainsi la pérennité des données sous-jacentes.
Sous-traitants publiés
Les sous-traitants de l'infrastructure sont listés sur la page de confiance, avec une notification avant toute modification.
Pour connaître les normes auxquelles nous sommes soumis et la manière dont nous vous accompagnons dans vos obligations de conformité, consultez la présentation Conformité des données et le guide du développeur Sécurité des données.
Création d'un flux d'exportation ?
Parlez à un ingénieur de la tâche d'exportation de l'administrateur, du téléchargement signé, du manifeste de couverture ou de l'exportation de la personne concernée par membre.
Parlez à l'ingénierie