Перейти до вмісту

Бібліотека файлів

Бібліотека файлів відображає вихідні файли, результати завдань та файли додатків, до яких має доступ поточний обліковий запис. Кожен елемент має стабільний file_id і повертає дії, які виконувач може виконувати наразі.

Документи, що використовуються як вхідні дані для перекладу, також мають ендпоінти /api/v1/documents — список, деталізація, оновлення та видалення. document_id призначений для створення завдань обробки; file_id — для налаштування прав доступу та завантажень у межах бібліотеки. Не вважайте ці два ідентифікатори взаємозамінними.

Перелік та деталізоване опис

Section titled “Перелік та деталізоване опис”
GET /api/v1/storage/files?offset=0&limit=50
GET /api/v1/storage/files/{file_id}

Список відповіді:

{
"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
}

Щоб отримати наступну сторінку, передайте next_offset як offset; зупиніться, коли has_more дорівнюватиме false.

Завжди використовуйте capabilities кожного елемента, щоб визначити, чи його можна завантажувати, надавати у спільне користування або надавати додатку; не робіть висновків про дозволи на основі вихідних полів.

GET /api/v1/storage/files/{file_id}/content
POST /api/v1/storage/files/{file_id}/download-ticket

/content перенаправляє (302) на тимчасову адресу завантаження; не надсилайте ключ API під час переходу за перенаправленням. Рекомендується спочатку запитати download-ticket. Запитуйте нову адресу після закінчення терміну дії попередньої; не зберігайте її.

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}

Зміни дозволів та публічні посилання — це окремі функції. Під час створення посилання явно встановіть його аудиторію, дозвіл на завантаження, термін дії та необов’язкову кількість завантажень; скасуйте його, щойно воно стане непотрібним.

Представления робочого простору

Section titled “Представления робочого простору”
GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

Кінцеві точки робочого простору підходять для файлового центру; /storage/files відповідає за дії щодо надання дозволів та завантаження окремого файлу.