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