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.