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.