Kết quả và tệp tải xuống
Danh sách sản phẩm
Phần tiêu đề “Danh sách sản phẩm”GET /api/v1/artifacts?job_id={job_id}GET /api/v1/artifacts/{artifact_id}Các đối tượng chỉ hiển thị với tài khoản sở hữu. Đọc danh sách sau khi công việc hoàn tất.
Tải xuống trực tiếp
Phần tiêu đề “Tải xuống trực tiếp”GET /api/v1/artifacts/{artifact_id}/downloadcurl --fail-with-body -OJ \ https://omnidoc.top/api/v1/artifacts/6n2b7z5q8v4m1c3k/download \ -H "X-API-Key: $OMNIDOC_API_KEY"Tính năng tải xuống hỗ trợ ETag và các yêu cầu có điều kiện. Truyền phát các tệp lớn ra đĩa thay vì đọc toàn bộ vào bộ nhớ cùng lúc.
Chiến lược tải xuống
Phần tiêu đề “Chiến lược tải xuống”GET /api/v1/artifacts/{artifact_id}/download-linkTrả về:
{ "mode": "direct", "url": "https://download.example/...", "filename": "report.en.docx"}Khách hàng cũng phải xử lý tình trạng url là null; sau đó sử dụng điểm cuối tải xuống trực tiếp. Lấy một URL ngắn hạn mới sau khi URL hiện tại hết hạn.
Xem trước
Phần tiêu đề “Xem trước”GET /api/v1/artifacts/{artifact_id}/preview-urlKết quả HTML, SVG và XML luôn được tải xuống dưới dạng tệp đính kèm.
Tên tệp
Phần tiêu đề “Tên tệp”Trước tiên hãy phân tích cú pháp RFC 5987 filename*, sau đó mới chuyển sang filename. Dù bạn sử dụng phương án nào, chỉ giữ lại tên cơ sở và cắt ngắn hoặc thay thế các ký tự không hợp lệ theo quy tắc của hệ thống tập tin địa phương.
Một tác vụ có thể trả về nhiều sản phẩm hoặc một kết quả được đóng gói. Hãy dựa vào format trong danh sách sản phẩm và các tiêu đề phản hồi tải xuống; không được suy đoán loại phản hồi từ phần mở rộng của tệp nguồn.