Manuale · 10

Endpoint delle app

Vedi App per i dettagli funzionali. Tutti gli endpoint tranne GET /apps/mine sono riservati agli amministratori.

Metodo Percorso Descrizione
GET /apps Elenca le app
GET /apps/mine App pubblicate che il chiamante può aprire (anche utenti app e viewer)
POST /apps Crea un’app (name, opzionali slug, description, access, definition)
POST /apps/import Crea un’app da un file di esportazione
GET /apps/{id} App con la bozza (definition)
PATCH /apps/{id} Modifica impostazioni o bozza
DELETE /apps/{id} Elimina un’app (con versioni e abilitazioni)
POST /apps/{id}/publish Pubblica la bozza come versione successiva
POST /apps/{id}/unpublish Metti offline
GET /apps/{id}/versions Versioni pubblicate
POST /apps/{id}/versions/{version}/restore Ripristina una versione come bozza
GET /apps/{id}/export Bozza come file
GET /apps/{id}/access Utenti e gruppi abilitati
PUT /apps/{id}/access Imposta le abilitazioni ({"users": [...], "groups": [...]})
GET /apps/{id}/icon Icona come PNG (propria o iniziale)
PUT /apps/{id}/icon Imposta l’icona propria (corpo: immagine)
DELETE /apps/{id}/icon Rimuovi l’icona propria

Le definizioni non valide ricevono 400 invalid_app_definition con la posizione (es. pages[0].elements[2]: outside the grid). Un indirizzo già usato dà 409 app_slug_taken.

Sorgenti REST (solo amministratori)

Metodo Percorso Descrizione
GET /app-sources Elenca le sorgenti REST (senza valori degli header)
POST /app-sources Crea una sorgente (name, base_url, headers)
PATCH /app-sources/{id} Modifica una sorgente (headers sostituisce tutti gli header)
DELETE /app-sources/{id} Elimina una sorgente

Runtime di un’app

Fuori da /api/v1 – la chiama l’app nel browser. Accesso via sessione (app con accesso) o nessuno (app pubbliche); ?draft=1 solo per amministratori.

Metodo Percorso Descrizione
GET /app/<slug>/_api/app Definizione per il browser (query solo con nome, tipo e parametri, senza workflow)
POST /app/<slug>/_api/query/<name> Esegui una query ({"params": {…}, "offset", "limit", "sort"}; query di caricamento: multipart/form-data con params (JSON) e file, al massimo 50 MB)
GET /app/<slug>/_api/file/<query>/<id-file>[/thumbnail] un file di una colonna allegati (o la sua anteprima) – solo se la query di lettura indicata (elenco, record, workflow) raggiunge la tabella del file, con un’autorizzazione di lettura proprio su quella tabella; altrimenti 404
GET /app/<slug>/manifest.webmanifest Manifest della PWA
GET /app/<slug>/icon-192.png, icon-512.png Icone della PWA
GET /app/<slug>/sw.js Service worker

Modelli: POST /apps accetta anche template (crud, form, dashboard) con table (ID della tabella) e lang per i testi, vedi Modelli. Errori 400: app_template_unknown, app_template_table_required, app_template_table_unknown, app_template_table_readonly, app_template_no_fields.