Ekspor Data Ruang Kerja
Ekspor seluruh ruang kerja sebagai satu arsip JSON. Admin ruang kerja memintanya dari Akun → Data & Ekspor di aplikasi, atau melalui API di bawah ini — ini berjalan sebagai pekerjaan asinkron, diunduh melalui tautan bertanda tangan berumur pendek, dan diawali dengan manifes cakupan sehingga Anda dapat memverifikasi kelengkapannya. Rahasia dikecualikan dan setiap permintaan diaudit.
Bentuknya
Hanya untuk admin
Titik akhir ekspor memerlukan admin ruang kerja. Titik akhir ini mencakup seluruh ruang kerja, sehingga aksesnya dibatasi untuk peran yang diizinkan untuk melihat semuanya.
Asinkron berdasarkan desain
Sebuah permintaan akan memasukkan tugas latar belakang yang merakit arsip, sehingga ruang kerja yang besar tidak pernah terblokir oleh satu permintaan HTTP. Anda cukup memeriksa statusnya, lalu mengunduh.
Unduhan yang ditandatangani dan berumur pendek
Arsip yang sudah selesai diambil melalui tautan bertanda tangan yang akan kedaluwarsa segera setelah diterbitkan — bukan URL publik atau permanen.
Diaudit dari ujung ke ujung
Setiap permintaan ekspor dan setiap unduhan dicatat dalam jejak audit, sehingga siapa yang mengekspor apa, dan kapan, selalu tercatat.
Minta ekspor
Satu titik akhir khusus admin memulai pekerjaan latar belakang. Ini segera kembali dengan ID pekerjaan; arsip disusun di balik layar.
// 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).Polling, lalu unduh
// 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.Manifest cakupan
Arsip adalah satu dokumen JSON yang dibuka dengan manifes setiap bagian yang disertakan dan jumlah catatannya — sehingga kelengkapannya dapat diverifikasi, bukan diasumsikan. Nama-nama kolom di bawah ini merupakan 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.
}Ekspor operasional & terjadwal
Selain arsip ruang kerja lengkap, admin dapat mengekspor tabel members atau orders secara terpisah — sebagai CSV atau JSONL, sekali atau sesuai jadwal harian/mingguan — dan secara opsional setiap proses dapat didorong ke gudang data Anda melalui webhook yang ditandatangani. Pengaturan admin yang sama, pekerjaan asinkron, unduhan yang ditandatangani, dan jejak audit; dibatasi untuk ekstrak yang mudah dikelola.
// 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 dicakup arsip
Ekspor mencakup seluruh ruang kerja. Bagian besar dibatasi untuk unduhan yang mudah dikelola, dan manifes mencatat di mana pun batasan diterapkan.
Rahasia dikecualikan
API kunci, kredensial, dan token sengaja tidak dimasukkan ke dalam arsip. Portabilitas data tidak pernah berarti mengekspor kunci ke integrasi Anda.
Data pribadi per anggota memiliki ekspor tersendiri
Arsip ruang kerja ini adalah data operasional. Data pribadi terperinci tentang anggota individu disajikan melalui ekspor subjek data per anggota.
Bagaimana data ditangani
Cloud terkelola, satu wilayah
Platform ini berjalan di atas infrastruktur cloud terkelola di satu wilayah.
Terenkripsi saat transit & saat diam
TLS pada jaringan dan AES-256 saat diam — termasuk file arsip ekspor itu sendiri.
Pencadangan basis data terkelola
Basis data yang dikelola dicadangkan, sehingga data yang mendasarinya tahan lama.
Sub-prosesor yang dipublikasikan
Sub-prosesor infrastruktur tercantum di halaman kepercayaan, dengan pemberitahuan sebelum mereka berubah.
Untuk standar yang kami patuhi dan bagaimana kami mendukung kewajiban kepatuhan Anda, lihat ikhtisar Kepatuhan Data dan panduan pengembang Keamanan Data.
Membangun alur ekspor?
Bicaralah dengan seorang insinyur tentang pekerjaan ekspor admin, unduhan yang ditandatangani, manifes cakupan, atau ekspor subjek data per anggota.
Bicara dengan bagian teknik