Files
SnapOtter/apps/docs/vi/tools/files/convert-document.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.7 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 Word, OpenDocument, RTF và văn bản thuần túy. 89771292569d human 17ac03cea231

Convert Document

Chuyển đổi tài liệu giữa các định dạng Word (DOCX), OpenDocument (ODT), RTF và văn bản thuần túy bằng LibreOffice.

API Endpoint

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

Nhận dữ liệu multipart form với một tệp Word/ODT/RTF/TXT và một trường JSON settings.

Parameters

Parameter Type Required Default Description
format string Yes - Định dạng đầu ra: docx, odt, rtf, txt

Example Request

curl -X POST http://localhost:1349/api/v1/tools/files/convert-document \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@report.docx" \
  -F 'settings={"format": "odt"}'

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: .docx, .doc, .odt, .rtf, .txt.
  • Việc chuyển đổi được xử lý bởi LibreOffice chạy ở chế độ headless trên máy chủ.
  • Định dạng phức tạp (macro, đối tượng nhúng) có thể không được giữ nguyên khi chuyển đổi giữa các định dạng.
  • Định dạng đầu ra phải khác với định dạng đầu vào.