Thư viện tệp
Thư viện tệp hiển thị các tệp nguồn, kết quả công việc và tệp ứng dụng mà tài khoản hiện tại có thể truy cập. Mỗi mục đều có một file_id ổn định và trả về các hành động mà người gọi hiện có thể thực hiện.
Các tài liệu được dùng làm đầu vào dịch thuật cũng có các điểm cuối /api/v1/documents để liệt kê, chi tiết hóa, cập nhật và xóa. document_id dùng để tạo công việc xử lý; file_id dùng cho quyền hạn và tải xuống trên toàn thư viện. Không được giả định rằng hai ID này có thể thay thế cho nhau.
Liệt kê và chi tiết
Phần tiêu đề “Liệt kê và chi tiết”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Danh sách phản hồi:
{ "items": [ { "id": "x7m4q2k9n6c1v8pa", "name": "report.docx", "content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "size_bytes": 45678, "status": "ready", "publication_status": "draft", "origin": { "product_code": "omnidoc-main", "display_name": "OmniDoc" }, "capabilities": { "can_view": true, "can_download": true, "can_update": true, "can_delete": true, "can_share": true }, "created_at": "2026-10-01T12:00:00Z", "updated_at": "2026-10-01T12:00:00Z" } ], "has_more": true, "next_offset": 50}Để lấy trang tiếp theo, truyền next_offset làm offset; dừng khi has_more là false.
Luôn sử dụng capabilities của từng mục để xác định xem nó có thể được tải xuống, chia sẻ hay cấp cho một ứng dụng hay không; không được suy luận quyền hạn từ các trường nguồn.
Tải xuống
Phần tiêu đề “Tải xuống”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content chuyển hướng (302) đến một địa chỉ tải xuống có thời hạn ngắn; không gửi khóa API khi theo dõi chuyển hướng. Nên yêu cầu download-ticket trước. Yêu cầu địa chỉ mới sau khi địa chỉ cũ hết hạn; không lưu trữ địa chỉ này.
Quyền hạn và liên kết
Phần tiêu đề “Quyền hạn và liên kết”GET /api/v1/storage/files/{file_id}/permissionsPOST /api/v1/storage/files/{file_id}/permissionsDELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/linksPOST /api/v1/storage/files/{file_id}/linksDELETE /api/v1/storage/files/{file_id}/links/{link_id}Thay đổi quyền và liên kết công khai là các tính năng riêng biệt. Khi tạo liên kết, hãy chỉ định rõ đối tượng xem, quyền tải xuống, thời hạn sử dụng và số lượt tải xuống tùy chọn; hủy liên kết ngay khi không còn cần thiết.
Chế độ xem không gian làm việc
Phần tiêu đề “Chế độ xem không gian làm việc”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsCác điểm cuối không gian làm việc phù hợp với trung tâm tệp; /storage/files phù hợp với các hành động cấp phép và tải xuống trên một tệp duy nhất.