Eksport Data Ruang Kerja
Eksport keseluruhan ruang kerja sebagai satu arkib JSON. Pentadbir ruang kerja memintanya daripada Akaun → Data & Eksport dalam aplikasi, atau melalui API di bawah — ia berjalan sebagai kerja asinkron, dimuat turun melalui pautan bertandatangan jangka pendek dan bakal pelanggan dengan manifes liputan supaya anda boleh mengesahkan kesempurnaan. Rahsia dikecualikan dan setiap permintaan diaudit.
Bentuknya
Pentadbir sahaja
Titik akhir eksport memerlukan pentadbir ruang kerja. Ia meliputi seluruh ruang kerja, jadi ia dikawal selia kepada peranan yang dibenarkan untuk melihat semuanya.
Asynchronous oleh reka bentuk
Permintaan akan memasukkan tugas latar belakang ke dalam barisan yang akan mengumpulkan arkib, jadi ruang kerja yang besar tidak akan menyekat satu permintaan HTTP. Anda membuat tinjauan untuk status, kemudian muat turun.
Muat turun bertandatangan, jangka pendek
Arkib yang telah siap diambil melalui pautan yang ditandatangani yang tamat tempoh sejurus selepas dikeluarkan — bukan URL awam atau kekal.
Diaudit dari hujung ke hujung
Setiap permintaan eksport dan setiap muat turun ditulis pada jejak audit, jadi siapa yang mengeksport apa, dan bila, sentiasa direkodkan.
Minta eksport
Satu titik akhir pentadbir sahaja memulakan kerja latar belakang. Ia kembali serta-merta dengan ID kerja; arkib dipasang di sebalik tabir.
// 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).Undian, kemudian muat turun
// 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.Manifes liputan
Arkib ialah satu dokumen JSON yang dibuka dengan manifes setiap bahagian yang disertakan dan kiraan rekodnya — jadi kelengkapan boleh disahkan, bukan diandaikan. Nama medan di bawah adalah ilustrasi bentuk manifes.
// 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.
}Eksport operasi & berjadual
Selain arkib ruang kerja penuh, pentadbir boleh mengeksport jadual ahli atau pesanan sendiri — sebagai CSV atau JSONL, sekali atau pada jadual harian/mingguan — dan secara pilihan, setiap larian dihantar ke gudang data anda melalui webhook yang ditandatangani. Pintu pentadbir yang sama, kerja asinkron, muat turun yang ditandatangani dan jejak audit; dihadkan untuk ekstrak yang boleh diurus.
// 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.Apa yang diliputi oleh arkib
Eksport merangkumi seluruh ruang kerja. Bahagian besar dihadkan untuk muat turun yang boleh diurus, dan nota manifes di mana sahaja had dikenakan.
Rahsia dikecualikan
API kunci, kelayakan dan token sengaja ditinggalkan daripada arkib. Kebolehgerakan data tidak pernah bermaksud mengeksport kunci ke integrasi anda.
Data peribadi setiap ahli mempunyai eksportnya sendiri
Arkib ruang kerja ini ialah data operasi. Data peribadi terperinci tentang ahli individu disampaikan melalui eksport subjek data setiap ahli.
Cara data dikendalikan
Awan terurus, rantau tunggal
Platform ini berjalan pada infrastruktur awan terurus dalam satu rantau.
Disulitkan semasa transit & semasa rehat
TLS pada wayar dan AES-256 dalam keadaan rehat — termasuk fail arkib eksport itu sendiri.
Sandaran pangkalan data terurus
Pangkalan data terurus disandarkan, jadi data asasnya tahan lama.
Sub-pemproses diterbitkan
Sub-pemproses infrastruktur disenaraikan di halaman kepercayaan, dengan notis sebelum ia berubah.
Untuk piawaian yang kami patuhi dan cara kami menyokong kewajipan pematuhan anda, lihat gambaran keseluruhan Pematuhan Data dan panduan pembangun Keselamatan Data.
Membina aliran eksport?
Bercakap dengan jurutera tentang kerja eksport pentadbir, muat turun yang ditandatangani, manifes liputan atau eksport subjek data setiap ahli.
Bercakap dengan jurutera