Manual · 10
Endpoints de apps
Consulta Apps para los detalles funcionales. Todos los endpoints salvo GET /apps/mine son solo para administradores.
| Método | Ruta | Descripción |
|---|---|---|
| GET | /apps |
Listar apps |
| GET | /apps/mine |
Apps publicadas que el llamante puede abrir (también usuarios de apps y viewers) |
| POST | /apps |
Crear una app (name, opcional slug, description, access, definition) |
| POST | /apps/import |
Crear una app desde un archivo de exportación |
| GET | /apps/{id} |
App con su borrador (definition) |
| PATCH | /apps/{id} |
Cambiar la configuración o el borrador |
| DELETE | /apps/{id} |
Eliminar una app (con versiones y habilitaciones) |
| POST | /apps/{id}/publish |
Publicar el borrador como siguiente versión |
| POST | /apps/{id}/unpublish |
Desconectar |
| GET | /apps/{id}/versions |
Versiones publicadas |
| POST | /apps/{id}/versions/{version}/restore |
Restaurar una versión como borrador |
| GET | /apps/{id}/export |
Borrador como archivo |
| GET | /apps/{id}/access |
Usuarios y grupos habilitados |
| PUT | /apps/{id}/access |
Establecer habilitaciones ({"users": [...], "groups": [...]}) |
| GET | /apps/{id}/icon |
Icono como PNG (propio o inicial) |
| PUT | /apps/{id}/icon |
Fijar el icono propio (cuerpo: imagen) |
| DELETE | /apps/{id}/icon |
Quitar el icono propio |
Las definiciones no válidas se responden con 400 invalid_app_definition indicando el lugar (p. ej. pages[0].elements[2]: outside the grid). Una dirección ocupada da 409 app_slug_taken.
Fuentes REST (solo administradores)
| Método | Ruta | Descripción |
|---|---|---|
| GET | /app-sources |
Listar fuentes REST (sin valores de encabezados) |
| POST | /app-sources |
Crear una fuente (name, base_url, headers) |
| PATCH | /app-sources/{id} |
Cambiar una fuente (headers reemplaza todos los encabezados) |
| DELETE | /app-sources/{id} |
Eliminar una fuente |
Ejecución de una app
Fuera de /api/v1 – la llama la app en el navegador. Sesión (apps con inicio de sesión) o ninguna (apps públicas); ?draft=1 solo para administradores.
| Método | Ruta | Descripción |
|---|---|---|
| GET | /app/<slug>/_api/app |
Definición para el navegador (consultas solo con nombre, tipo y parámetros, sin workflows) |
| POST | /app/<slug>/_api/query/<name> |
Ejecutar una consulta ({"params": {…}, "offset", "limit", "sort"}; consultas de subida: multipart/form-data con params (JSON) y file, como máximo 50 MB) |
| GET | /app/<slug>/_api/file/<consulta>/<id-archivo>[/thumbnail] |
un archivo de una columna de adjuntos (o su miniatura) – solo si la consulta de lectura indicada (lista, registro, workflow) llega a la tabla del archivo, con un permiso de lectura justo sobre esa tabla; si no, 404 |
| GET | /app/<slug>/manifest.webmanifest |
Manifiesto de la PWA |
| GET | /app/<slug>/icon-192.png, icon-512.png |
Iconos de la PWA |
| GET | /app/<slug>/sw.js |
Service worker |
Plantillas: POST /apps acepta también template (crud, form, dashboard) con table (ID de la tabla) y lang para los textos, consulta Plantillas. Errores 400: app_template_unknown, app_template_table_required, app_template_table_unknown, app_template_table_readonly, app_template_no_fields.