Бібліотека файлів
Бібліотека файлів відображає вихідні файли, результати завдань та файли додатків, до яких має доступ поточний обліковий запис. Кожен елемент має стабільний file_id і повертає дії, які виконувач може виконувати наразі.
Документи, що використовуються як вхідні дані для перекладу, також мають ендпоінти /api/v1/documents — список, деталізація, оновлення та видалення. document_id призначений для створення завдань обробки; file_id — для налаштування прав доступу та завантажень у межах бібліотеки. Не вважайте ці два ідентифікатори взаємозамінними.
Перелік та деталізоване опис
Section titled “Перелік та деталізоване опис”GET /api/v1/storage/files?offset=0&limit=50GET /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 кожного елемента, щоб визначити, чи його можна завантажувати, надавати у спільне користування або надавати додатку; не робіть висновків про дозволи на основі вихідних полів.
Завантажити
Section titled “Завантажити”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content перенаправляє (302) на тимчасову адресу завантаження; не надсилайте ключ API під час переходу за перенаправленням. Рекомендується спочатку запитати download-ticket. Запитуйте нову адресу після закінчення терміну дії попередньої; не зберігайте її.
Дозволи та посилання
Section titled “Дозволи та посилання”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}Зміни дозволів та публічні посилання — це окремі функції. Під час створення посилання явно встановіть його аудиторію, дозвіл на завантаження, термін дії та необов’язкову кількість завантажень; скасуйте його, щойно воно стане непотрібним.
Представления робочого простору
Section titled “Представления робочого простору”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsКінцеві точки робочого простору підходять для файлового центру; /storage/files відповідає за дії щодо надання дозволів та завантаження окремого файлу.