Handbuch · 10
Apps-Endpunkte
Siehe Apps für die fachlichen Details. Alle Endpunkte außer GET /apps/mine sind Admin-only.
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /apps |
Apps auflisten |
| GET | /apps/mine |
Veröffentlichte Apps, die der Aufrufer öffnen darf (auch App-Nutzer und Viewer) |
| POST | /apps |
App anlegen (name, optional slug, description, access, definition – oder template crud/form/dashboard mit table (Tabellen-ID) und lang für die Texte, siehe Vorlagen) |
| POST | /apps/import |
App aus einer Exportdatei anlegen |
| GET | /apps/{id} |
App mit Entwurf (definition) |
| PATCH | /apps/{id} |
Einstellungen oder Entwurf ändern |
| DELETE | /apps/{id} |
App löschen (mit Versionen und Freigaben) |
| POST | /apps/{id}/publish |
Entwurf als nächste Version veröffentlichen |
| POST | /apps/{id}/unpublish |
Offline nehmen |
| GET | /apps/{id}/versions |
Veröffentlichte Versionen |
| POST | /apps/{id}/versions/{version}/restore |
Version als Entwurf wiederherstellen |
| GET | /apps/{id}/export |
Entwurf als Datei |
| GET | /apps/{id}/access |
Freigegebene Nutzer und Gruppen |
| PUT | /apps/{id}/access |
Freigaben setzen ({"users": [...], "groups": [...]}) |
| GET | /apps/{id}/icon |
Icon als PNG (eigenes oder Anfangsbuchstabe) |
| PUT | /apps/{id}/icon |
Eigenes Icon setzen (Body: Bild) |
| DELETE | /apps/{id}/icon |
Eigenes Icon entfernen |
Ungültige Definitionen beantwortet der Server mit 400 invalid_app_definition und nennt die Stelle (z. B. pages[0].elements[2]: outside the grid). Eine vergebene Adresse ergibt 409 app_slug_taken. Vorlagen antworten bei Problemen mit 400 und app_template_unknown, app_template_table_required, app_template_table_unknown, app_template_table_readonly (kein einzelner Primärschlüssel) oder app_template_no_fields.
REST-Quellen (Admin-only)
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /app-sources |
REST-Quellen auflisten (ohne Header-Werte) |
| POST | /app-sources |
Quelle anlegen (name, base_url, headers) |
| PATCH | /app-sources/{id} |
Quelle ändern (headers ersetzt alle Header) |
| DELETE | /app-sources/{id} |
Quelle löschen |
Laufzeit einer App
Außerhalb von /api/v1 – die App im Browser ruft sie auf. Anmeldung per Sitzung (Apps mit Anmeldung) oder keine (öffentliche Apps); ?draft=1 nur für Admins.
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /app/<slug>/_api/app |
Definition für den Browser (Abfragen nur mit Name, Typ und Parametern, ohne Workflows) |
| POST | /app/<slug>/_api/query/<name> |
Abfrage ausführen ({"params": {…}, "offset", "limit", "sort"}; Upload-Abfragen: multipart/form-data mit params (JSON) und file, höchstens 50 MB) |
| GET | /app/<slug>/_api/file/<abfrage>/<datei-id>[/thumbnail] |
Datei aus einer Anhang-Spalte (bzw. ihr Vorschaubild) – nur, wenn die genannte lesende Abfrage (Liste, Datensatz, Workflow) die Tabelle der Datei erreicht, mit der Lese-Freigabe genau dieser Tabelle; sonst 404 |
| GET | /app/<slug>/manifest.webmanifest |
Manifest der PWA |
| GET | /app/<slug>/icon-192.png, icon-512.png |
Icons der PWA |
| GET | /app/<slug>/sw.js |
Service Worker |