Arbeitsbereichsdatenexport

Export anfordern

Ein Nur-Administrator-Endpunkt startet einen Hintergrundjob. Es kehrt sofort mit einer Job-ID zurück; Das Archiv wird hinter den Kulissen zusammengestellt.

// 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).

Umfrage durchführen, dann herunterladen

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

Das Abdeckungsmanifest

Das Archiv ist ein JSON-Dokument, das mit einem Manifest jedes enthaltenen Abschnitts und seiner Datensatzanzahl geöffnet wird – die Vollständigkeit ist also überprüfbar und nicht vorausgesetzt. Die folgenden Feldnamen veranschaulichen die Form des Manifests.

// 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.
}

Operative und geplante Exporte

Neben dem Archiv des gesamten Arbeitsbereichs kann ein Administrator die Tabellen members oder orders einzeln exportieren – als CSV oder JSONL, einmalig oder täglich/wöchentlich – und optional jeden Exportlauf per signiertem Webhook an Ihr Data Warehouse übertragen lassen. Gleiche administrative Zugriffskontrolle, asynchroner Job, signierter Download und Audit-Trail; begrenzt auf einen überschaubaren Datenexport.

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

Wie die Daten verarbeitet werden

Informationen zu den Standards, an die wir uns halten, und wie wir Sie bei der Erfüllung Ihrer Compliance-Verpflichtungen unterstützen, finden Sie in der Datenkonformität-Übersicht und im Datensicherheit-Entwicklerhandbuch.