การส่งออกข้อมูลพื้นที่ทำงาน

ขอส่งออก

จุดสิ้นสุดสำหรับผู้ดูแลระบบเท่านั้นจะเริ่มงานเบื้องหลัง มันกลับมาทันทีพร้อมรหัสงาน เอกสารสำคัญถูกรวบรวมไว้เบื้องหลัง

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

แบบสำรวจแล้วดาวน์โหลด

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

รายการความคุ้มครอง

ไฟล์เก็บถาวรคือเอกสาร JSON หนึ่งเอกสารที่เปิดขึ้นพร้อมกับรายการของทุกส่วนที่รวมไว้และจำนวนบันทึกในนั้น ดังนั้นจึงสามารถตรวจสอบความสมบูรณ์ได้ ไม่ใช่สันนิษฐาน ชื่อฟิลด์ด้านล่างนี้เป็นตัวอย่างของรูปร่างของรายการ

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

การส่งออกเชิงปฏิบัติการและตามกำหนดการ

นอกจากการเก็บถาวรพื้นที่ทำงานแบบเต็มแล้ว ผู้ดูแลระบบยังสามารถส่งออกตาราง สมาชิก หรือ คำสั่งซื้อ ด้วยตนเอง — เป็น CSV หรือ JSONL ครั้งเดียวหรือตามกำหนดเวลารายวัน/สัปดาห์ และเลือกที่จะให้การเรียกใช้แต่ละครั้งส่งไปยังคลังข้อมูลของคุณผ่าน webhook ที่ลงนามหรือไม่ก็ได้ การควบคุมผู้ดูแลระบบคนเดียวกัน งานอะซิงก์ การดาวน์โหลดที่เซ็นชื่อ และเส้นทางการตรวจสอบ ต่อยอดเป็นสารสกัดที่สามารถจัดการได้

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

วิธีการจัดการข้อมูล

สำหรับมาตรฐานที่เรายึดถือและวิธีที่เราสนับสนุนภาระผูกพันในการปฏิบัติตามข้อกำหนดของคุณ โปรดดูภาพรวม การปฏิบัติตามข้อกำหนดของข้อมูล และคู่มือนักพัฒนา ความปลอดภัยของข้อมูล