Apps personalizadas (Custom Gestiono Apps)
Subir, publicar y probar releases
Crear la app, preparar el bundle y publicar
Una app se ejecuta a partir de un release: un archivo .js que Gestiono carga dentro del Dashboard.
1) Crear la app
Crea la app con POST /v1/apps y guarda el appId.
2) Preparar el bundle
- Salida: 1 archivo
.js. - Entrada: Tu código debe montar UI dentro de
#app-container-<appId>. - Networking: Si llamas a la API desde el browser, usa cookies/sesión (no expongas API keys privadas).
3) Subir el release
Sube el archivo usando POST /v1/apps/release (multipart/form-data). El campo del archivo debe llamarse appJs.
4) Ver releases
Lista releases con GET /v1/apps/release?appId=....
5) Probar la app
En el Dashboard puedes abrir /app/<appId>. Gestiono buscará el último release y lo cargará como script.
Modo DEV: cargar un bundle sin subir release
Puedes apuntar el Dashboard a un JS alojado externamente usando ?appJs=:
/app/123?appJs=https://tu-host.com/app.dev.js
Release reach y aprobación
- PRIVATE: Pensado para uso interno/privado.
- ORGANIZATION: Visible para la organización dueña (y su entorno).
- PUBLIC: Pensado para catálogo/marketplace (suele requerir aprobación).
Nota: el backend actual puede forzar el reach a ORGANIZATION cuando subes el release.
Para la documentación completa de rutas y payloads, ve a Endpoints: Apps personalizadas.