워크스페이스 데이터 내보내기

내보내기 요청

하나의 관리자 전용 엔드포인트가 백그라운드 작업을 시작합니다. 작업 ID와 함께 즉시 반환됩니다. 아카이브는 무대 뒤에서 조립됩니다.

// 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 형식으로 한 번 또는 매일/매주 일정에 따라 개별적으로 내보낼 수 있으며, 선택적으로 각 실행 결과를 서명된 웹훅을 통해 데이터 웨어하우스로 푸시할 수 있습니다. 동일한 관리자 권한 부여, 비동기 작업, 서명된 다운로드 및 감사 추적 기능을 제공하며, 관리 가능한 추출 크기로 제한됩니다.

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

데이터 처리 방식

당사가 준수하는 표준 및 귀사의 규정 준수 의무 지원 방법에 대한 자세한 내용은 데이터 규정 준수 개요 및 데이터 보안 개발자 가이드를 참조하십시오.