Bỏ qua để đến nội dung

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.

GET /api/v1/storage/files?offset=0&limit=50
GET /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.

GET /api/v1/storage/files/{file_id}/content
POST /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.

GET /api/v1/storage/files/{file_id}/permissions
POST /api/v1/storage/files/{file_id}/permissions
DELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/links
POST /api/v1/storage/files/{file_id}/links
DELETE /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.

GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

Cá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.