mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
1.6 KiB
1.6 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Chuyển đổi một EPUB sang PDF, DOCX, HTML hoặc Markdown. | 7d94fc18ca97 | human | 799e72fe641c |
Convert EPUB
Chuyển đổi một sách điện tử EPUB sang PDF, Word (DOCX), HTML hoặc Markdown. Các tài nguyên từ xa bên trong sách không được tải về.
API Endpoint
POST /api/v1/tools/files/epub-convert
Nhận dữ liệu multipart form với một tệp EPUB và một trường JSON settings.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| format | string | Yes | - | Định dạng đầu ra: pdf, docx, html, md |
Example Request
curl -X POST http://localhost:1349/api/v1/tools/files/epub-convert \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@book.epub" \
-F 'settings={"format": "pdf"}'
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
- Định dạng đầu vào được chấp nhận:
.epub. - Các tài nguyên từ xa nhúng trong EPUB (ảnh, phông chữ bên ngoài) không được tải về vì lý do bảo mật.
- Độ trung thực của hình ảnh trong đầu ra đã chuyển đổi có thể khác nhau tùy theo cấu trúc EPUB.
- Việc chuyển đổi được xử lý bởi Pandoc trên máy chủ.