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.
2.2 KiB
2.2 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Đọc và ghi metadata tài liệu PDF. | b2eaebf7467f | human | c6d162cbd092 |
PDF Metadata
Đọc và cập nhật các trường metadata tài liệu PDF như tiêu đề, tác giả, chủ đề và từ khóa. Khi không cung cấp cài đặt nào, metadata hiện có được trả về mà không sửa đổi.
API Endpoint
POST /api/v1/tools/pdf/pdf-metadata
Chấp nhận dữ liệu biểu mẫu multipart với một tệp PDF và một trường JSON settings tùy chọn.
Parameters
| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
| title | string | Không | - | Tiêu đề tài liệu (tối đa 500 ký tự) |
| author | string | Không | - | Tác giả tài liệu (tối đa 500 ký tự) |
| subject | string | Không | - | Chủ đề tài liệu (tối đa 500 ký tự) |
| keywords | string | Không | - | Từ khóa tài liệu (tối đa 500 ký tự) |
Tất cả các tham số đều tùy chọn. Các trường bị bỏ qua được giữ nguyên không thay đổi.
Example Request
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-metadata \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@report.pdf" \
-F 'settings={"title": "Q2 Report", "author": "Finance Team"}'
Example Response
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/report.pdf",
"originalSize": 245000,
"processedSize": 245200,
"metadata": {
"title": "Q2 Report",
"author": "Finance Team",
"subject": "",
"keywords": ""
}
}
Notes
- Định dạng đầu vào được chấp nhận:
.pdf. - Đây là một công cụ nhanh (đồng bộ) trả về kết quả trực tiếp.
- Trường
metadatatrong phản hồi chứa metadata kết quả sau mọi cập nhật. - Để đọc metadata mà không sửa đổi nó, hãy bỏ qua trường
settingshoặc gửi một đối tượng rỗng. - Mỗi trường metadata giới hạn ở 500 ký tự.