# API FSO **FSO** (*File System Operations*) es la API de dkl-web para administrar las carpetas y archivos de un sitio con privilegios por usuario: listar, consultar metadatos, guardar propiedades y manifiestos de privilegios, escribir archivos de texto, subir archivos (y descomprimir zip), crear carpetas, copiar, mover, renombrar y borrar. Implementa los servicios de un *Resources Directory* del RAAM de Induxsoft con dos interfaces: - **Servicios web**: URL con extensión `.fso` (`lst`, `get`, `set`, `upl`, `do` y `zip`), para el navegador o cualquier cliente. - **Biblioteca**: `fso.dk`, para usar lo mismo desde su código. Sirve de base para construir un administrador de archivos web y para dar carpetas con permisos por usuario en cualquier sitio. ## Instalación en un sitio Los servicios están en la carpeta `fso/` de la instalación. Un sitio los publica con una regla en `_protected/ext.map`: ```text .fso > $fso/fso.*.dkl ``` Cada servicio es un programa: `lst.fso` → `fso.lst.dkl`, `get.fso` → `fso.get.dkl`, `set.fso` → `fso.set.dkl`, `upl.fso` → `fso.upl.dkl`, `do.fso` → `fso.do.dkl` y `zip.fso` → `fso.zip.dkl`. La plantilla de sitio `blank` trae la regla escrita como `.fso > $/fso/fso.*.dkl` (ruta absoluta en la raíz del disco); cámbiela por la de arriba ([Crear un sitio](/es/devkron/2.0/marcos/sitios/crear-sitio.md#ajuste-necesario-en-extmap)). Sin un **manifiesto de privilegios** en la ruta, FSO niega todo a todos. Cree el primero a mano (vea [Privilegios](/es/devkron/2.0/marcos/fso/privilegios.md#primer-manifiesto-del-sitio)). ## Conceptos ### El recurso sobre el que se opera Es la **URL desde la que se llama al servicio, sin el nombre del servicio**: | URL | Recurso | |---|---| | `https://sitio.ejemplo.com/lst.fso` | `/` (raíz del sitio) | | `https://sitio.ejemplo.com/documentos/lst.fso` | `/documentos` | | `https://sitio.ejemplo.com/documentos/contrato.docx/get.fso` | `/documentos/contrato.docx` | Todos los servicios aceptan en la **cadena de consulta** (también los que reciben cuerpo): | Parámetro | Descripción | |---|---| | `uri` | Ruta del recurso, relativa a la carpeta del sitio; **sustituye** a la que se deduce de la URL. Las `\` se convierten en `/` | | `base_path` | Carpeta del servidor que se usa como base. Solo con `@dklfso_multisites=@true` | | `host` | Nombre de otro sitio del servidor; se usa `<@dklfso_websites_path>/` como base. Solo con `@dklfso_multisites=@true`; gana sobre `base_path` | Con `@dklfso_multisites` en `@false` (predeterminado), `base_path` y `host` se ignoran y la base es el sitio que atiende la petición. ### Autenticación FSO usa la sesión que arma el proveedor de identidad del sitio (`_protected/idp/default.dk`, a través de `auth.dk`). El token se busca con [auth.token](/es/devkron/2.0/marcos/autenticacion/webauth.md): parámetro `ids` o `token`, cookie `__induxsoft_token`, campo `session_id`, `Authorization: Bearer`... ```bash curl -H "Authorization: Bearer MI_TOKEN" "https://sitio.ejemplo.com/documentos/lst.fso" ``` Sin sesión, se evalúa como el usuario anónimo (`uid` = `*`): tendrá acceso solo si el manifiesto lo concede (por ejemplo, con `{"user":"+"}`). ### Formato de las respuestas Todos responden `Content-Type: application/json;charset=utf-8` y **estado 200**; el resultado va en el cuerpo. `success` sale como `1` o `0`: ```json { "success": 1, "data": { } } { "success": 0, "message": "descripción del error" } ``` - `success: 0` es un error general (JSON inválido, sin permiso para la carpeta de destino). - En `set`, `upl` y `do`, `data` trae **un resultado por recurso**; un error en uno no detiene los demás. Si un recurso trae `message`, falló: revise el mensaje antes de confiar en los indicadores `*_done`. ### Claves de URI en los cuerpos JSON En `set.fso` y `do.fso` el cuerpo es un objeto cuyas llaves son los recursos: | Llave | Recurso (llamando a `https://sitio.ejemplo.com/carpeta/...`) | |---|---| | `.` | La carpeta desde la que se llama: `/carpeta` | | `notas.txt` | Relativa: `/carpeta/notas.txt` | | `sub/archivo.txt` | Relativa: `/carpeta/sub/archivo.txt` | | `/otra/texto.txt` | Si empieza con `/`, relativa a la raíz del sitio: `/otra/texto.txt` | ## Contenido | Página | Qué aprenderá | |---|---| | [Servicios web](/es/devkron/2.0/marcos/fso/servicios.md) | `lst`, `get`, `set`, `upl`, `do` y `zip`: parámetros, cuerpos, respuestas reales y privilegios de cada uno | | [Metadatos y privilegios](/es/devkron/2.0/marcos/fso/privilegios.md) | Archivos `._m_` y `._p_`, formato del manifiesto, condiciones, herencia, privilegios por operación y el primer manifiesto | | [Biblioteca fso.dk y configuración](/es/devkron/2.0/marcos/fso/biblioteca.md) | `dklfso.list`, `createObjectInfo`, `auth`, `authOp`, `getPrivs`, `isprotected`, `parseRequest`, puntos de extensión, `fso.config.dk` y mensajes de error | La guía [Subir y servir archivos con FSO](/es/devkron/2.0/guias/archivos-fso.md) lo recorre de principio a fin.