Files
SnapOtter/apps/docs/vi/tools/files/convert-spreadsheet.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

1.6 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Chuyển đổi giữa các định dạng Excel, OpenDocument và CSV. b813b1b06962 human de2984be5fd5

Convert Spreadsheet

Chuyển đổi bảng tính giữa các định dạng Excel (XLSX), OpenDocument Spreadsheet (ODS) và CSV. Sổ làm việc nhiều trang sẽ xuất trang đầu tiên khi chuyển sang CSV.

API Endpoint

POST /api/v1/tools/files/convert-spreadsheet

Nhận dữ liệu multipart form với một tệp Excel/ODS/CSV và một trường JSON settings.

Parameters

Parameter Type Required Default Description
format string Yes - Định dạng đầu ra: xlsx, ods, csv

Example Request

curl -X POST http://localhost:1349/api/v1/tools/files/convert-spreadsheet \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@data.xlsx" \
  -F 'settings={"format": "csv"}'

Example Response

Trả về 202 Accepted. Theo dõi tiến trình qua SSE tại /api/v1/jobs/{jobId}/progress.

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Notes

  • Các định dạng đầu vào được chấp nhận: .xlsx, .xls, .ods, .csv.
  • Khi chuyển một sổ làm việc nhiều trang sang CSV, chỉ trang đầu tiên được xuất.
  • Công thức được tính toán và xuất dưới dạng giá trị tĩnh trong đầu ra CSV.
  • Định dạng đầu ra phải khác với định dạng đầu vào.