تصدير بيانات مساحة العمل

طلب تصدير

تبدأ نقطة نهاية واحدة خاصة بالمسؤولين فقط مهمة في الخلفية. تُعيد المهمة فورًا مع مُعرّفها؛ ويتم تجميع الأرشيف في الخلفية. يبدأ أحد نقاط النهاية، المُخصصة للمسؤولين فقط، مهمة في الخلفية.

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

الصادرات التشغيلية والمجدولة

إلى جانب أرشيف مساحة العمل الكاملة، يُمكن للمسؤول تصدير جدولي members أو orders بشكل منفصل - بصيغة CSV أو JSONL، لمرة واحدة أو وفقًا لجدول زمني يومي/أسبوعي - مع إمكانية إرسال كل عملية تصدير إلى مستودع البيانات الخاص بك عبر رابط ويب مُوقّع. نفس نظام التحكم الإداري، ووظيفة غير متزامنة، وتنزيل مُوقّع، وسجل تدقيق؛ مع تحديد حجم استخراج مُناسب.

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

كيفية معالجة البيانات

للاطلاع على المعايير التي نلتزم بها وكيفية دعمنا لالتزاماتكم المتعلقة بالامتثال، يُرجى مراجعة نظرة عامة على امتثال البيانات ودليل المطورين أمن البيانات.