Biblioteca de archivos
La biblioteca de archivos muestra los archivos fuente, los resultados de los trabajos y los archivos de la aplicación a los que puede acceder la cuenta actual. Cada elemento tiene un identificador file_id estable y devuelve las acciones que el llamante puede realizar en ese momento.
Los documentos utilizados como entrada de traducción también cuentan con los puntos finales /api/v1/documents de lista, detalle, actualización y eliminación. document_id sirve para crear trabajos de procesamiento; file_id es para permisos y descargas a nivel de biblioteca. No asuma que estos dos identificadores son intercambiables.
Enumerar y detallar
Sección titulada «Enumerar y detallar»GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Respuesta de la lista:
{ "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}Para obtener la página siguiente, pase next_offset como offset; deténgase cuando has_more sea false.
Utilice siempre el capabilities de cada elemento para determinar si puede descargarse, compartirse o concederse a una aplicación; no infiera permisos a partir de los campos de origen.
Descargar
Sección titulada «Descargar»GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content redirige (302) a una dirección de descarga de corta duración; no envíe la clave API al seguir la redirección. Se recomienda solicitar un download-ticket primero. Solicite una nueva dirección después de que caduque; no la almacene.
Permisos y enlaces
Sección titulada «Permisos y enlaces»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}Los cambios de permisos y los enlaces públicos son capacidades independientes. Al crear un enlace, configure explícitamente su audiencia, permiso de descarga, fecha de caducidad y un recuento opcional de descargas; revóquelo tan pronto como ya no sea necesario.
Vistas del espacio de trabajo
Sección titulada «Vistas del espacio de trabajo»GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsLos puntos finales del espacio de trabajo son adecuados para un centro de archivos; /storage/files es adecuado para acciones de permiso y descarga en un único archivo.