# Server SDK

> Prepara los servicios de documentos, el almacenamiento y los permisos de acceso de tu aplicación.

- Human documentation: [https://docs.univer.ai/es-ES/server](https://docs.univer.ai/es-ES/server)

- Agent Markdown: [https://docs.univer.ai/es-ES/server.md](https://docs.univer.ai/es-ES/server.md)

- Requested language: `es-ES`

- Content language: `es-ES`

- Documentation version: `1.2.0`

- Source: [index.es-ES.mdx](https://github.com/dream-num/documentation/blob/dev/content/server/index.es-ES.mdx)

---

**Univer Server SDK ofrece módulos combinables.** Integra los que necesites en tu backend y despliega esa aplicación. La autenticación, los permisos, la propiedad de documentos, el almacenamiento de archivos y la operación son responsabilidad de la aplicación.

Esta página trata la configuración del backend, el almacenamiento y los permisos. La [integración de colaboración](https://docs.univer.ai/es-ES/server/collaboration/browser-integration.md) conecta el editor con documentos compartidos. La [integración de intercambio de archivos](https://docs.univer.ai/es-ES/server/import-export.md) cubre subida, conversión y descarga. Sigue la guía de la función que necesites. Si requiere licencia, empieza por [configurar la licencia](https://docs.univer.ai/es-ES/server/license.md). La edición solo en el navegador no necesita un servicio de colaboración.

## Orden de integración

1. [Quick Start](https://docs.univer.ai/es-ES/server/collaboration/quick-start.md): comprobar edición bidireccional en dos contextos de navegador independientes.
2. [Persistencia](https://docs.univer.ai/es-ES/server/collaboration/database-adapters.md#verify-persistence): reiniciar SQLite y comprobar el valor.
3. [Identidad y permisos](https://docs.univer.ai/es-ES/server/collaboration/identity-and-authorization.md#verify-permissions): verificar editor y viewer.
4. [Frontend de negocio](https://docs.univer.ai/es-ES/server/collaboration/browser-integration.md): sustituir identidad, creación de documentos y URL de demostración.
5. [Extensiones](https://docs.univer.ai/es-ES/server/collaboration/examples.md): añadir historial, comentarios, Worktree o Exchange después del flujo básico. Para conversión sola, empezar por [Exchange](https://docs.univer.ai/es-ES/server/import-export/node.md).

## Elegir los servicios necesarios

| Necesidad                           | Preparación del backend                              | Guía                                                                                                               |
| ----------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Edición de documentos compartidos   | Collaboration SDK, almacenamiento y permisos         | [Inicio rápido de colaboración](https://docs.univer.ai/es-ES/server/collaboration/quick-start.md)                                                 |
| Importar y exportar archivos Office | Conversión, subidas, consultas de tareas y descargas | [Conversión de archivos](https://docs.univer.ai/es-ES/server/import-export/node.md) y [ejemplo Exchange](https://docs.univer.ai/es-ES/server/collaboration/examples.md#exchange) |
| Historial o comentarios compartidos | Sus respectivos servicios, almacenamiento y permisos | [Módulos de extensión](https://docs.univer.ai/es-ES/server/collaboration/extensions.md)                                                           |

Elige solo las capacidades necesarias. Convertir archivos no requiere edición colaborativa. Prepara el [entorno de los SDK](https://docs.univer.ai/es-ES/server/requirements.md) y mantén compatibles las versiones de los paquetes Univer.

## Conectar la aplicación y el almacenamiento

Ejecuta el ejemplo del servicio elegido y conéctalo al backend. Para documentos colaborativos, tu aplicación crea el documento, registra su propietario y devuelve el ID al navegador. Consulta las API de creación en [Límites de los módulos](https://docs.univer.ai/es-ES/server/collaboration/modules.md). Tu aplicación sigue gestionando usuarios, proyectos y carpetas.

El ejemplo de colaboración usa almacenamiento en memoria y pierde el contenido al reiniciar. Sigue [Adaptadores de base de datos](https://docs.univer.ai/es-ES/server/collaboration/database-adapters.md) para conectar una base de datos y verifica que los documentos guardados sobrevivan al reinicio.

La conversión también necesita almacenar y limpiar subidas, tareas y descargas. Sigue el [ejemplo Exchange](https://docs.univer.ai/es-ES/server/collaboration/examples.md#exchange).

## Conectar el inicio de sesión y los permisos

Sigue [Identidad y autorización](https://docs.univer.ai/es-ES/server/collaboration/identity-and-authorization.md) para validar las credenciales existentes y comprobar si un usuario puede leer o modificar un documento. Sustituye los usuarios fijos y las reglas que permiten todo del ejemplo.

Protege las lecturas, conexiones de colaboración, envíos de cambios y cualquier historial, comentario o descarga habilitados. Un editor de solo lectura en el navegador no sustituye las comprobaciones del servidor.

## Desplegar y conectar el frontend

Despliega las interfaces en el dominio de tu aplicación. Para colaborar, los proxies deben reenviar HTTP y WebSocket; las páginas HTTPS deben usar WSS. Limita las subidas y gestiona los fallos y tiempos de espera de conversión. Para pasar de una sola máquina a un nodo de importación y exportación separado y a varios nodos de colaboración, sigue la [Guía de despliegue](https://docs.univer.ai/es-ES/server/deployment.md).

Cuando el backend esté listo, completa la integración correspondiente:

* [Integración de colaboración](https://docs.univer.ai/es-ES/server/collaboration/browser-integration.md): conecta el editor, crea y abre documentos compartidos y verifica la sincronización.
* [Integración de intercambio de archivos](https://docs.univer.ai/es-ES/server/import-export.md): conecta subida, conversión y descarga y comprueba archivos reales.
