Перейти к содержимому

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

Библиотека файлов отображает исходные файлы, результаты заданий и файлы приложений, к которым имеет доступ текущая учётная запись. Каждый элемент имеет уникальный file_id и возвращает действия, которые вызывающий объект может выполнять в данный момент.

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

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}

Изменения разрешений и общедоступные ссылки — это отдельные возможности. При создании ссылки явно задавайте её аудиторию, разрешение на загрузку, срок действия и необязательное ограничение на количество загрузок; отменяйте ссылку сразу после того, как она перестанет быть необходимой.

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

Конечные точки рабочего пространства подходят для центра файлов; /storage/files поддерживает действия по управлению разрешениями и загрузке для одного файла.