Библиотека файлов
Библиотека файлов отображает исходные файлы, результаты заданий и файлы приложений, к которым имеет доступ текущая учётная запись. Каждый элемент имеет уникальный file_id и возвращает действия, которые вызывающий объект может выполнять в данный момент.
Документы, используемые в качестве входных данных для перевода, также имеют конечные точки /api/v1/documents — список, детализация, обновление и удаление. document_id предназначена для создания заданий обработки; file_id — для настройки разрешений на уровне библиотеки и загрузок. Не следует считать эти два идентификатора взаимозаменяемыми.
Список и подробное описание
Заголовок раздела «Список и подробное описание»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 каждого элемента для определения того, можно ли его загружать, передавать или предоставлять приложению; не выводите разрешения на основе исходных полей.
Скачать
Заголовок раздела «Скачать»GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticketПеренаправление /content (302) ведёт на временный адрес загрузки; при переходе по перенаправлению не отправляйте API‑ключ. Рекомендуется сначала запросить download-ticket. Запрашивайте новый адрес после истечения срока действия предыдущего; не сохраняйте его.
Разрешения и ссылки
Заголовок раздела «Разрешения и ссылки»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}Изменения разрешений и общедоступные ссылки — это отдельные возможности. При создании ссылки явно задавайте её аудиторию, разрешение на загрузку, срок действия и необязательное ограничение на количество загрузок; отменяйте ссылку сразу после того, как она перестанет быть необходимой.
Представления рабочего пространства
Заголовок раздела «Представления рабочего пространства»GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsКонечные точки рабочего пространства подходят для центра файлов; /storage/files поддерживает действия по управлению разрешениями и загрузке для одного файла.