Manuel · 10
Endpoints des apps
Voir Apps pour les détails fonctionnels. Tous les endpoints sauf GET /apps/mine sont réservés aux administrateurs.
| Méthode | Chemin | Description |
|---|---|---|
| GET | /apps |
Lister les apps |
| GET | /apps/mine |
Apps publiées que l’appelant peut ouvrir (aussi utilisateurs d’apps et viewers) |
| POST | /apps |
Créer une app (name, optionnel slug, description, access, definition) |
| POST | /apps/import |
Créer une app à partir d’un fichier d’export |
| GET | /apps/{id} |
App avec son brouillon (definition) |
| PATCH | /apps/{id} |
Modifier les paramètres ou le brouillon |
| DELETE | /apps/{id} |
Supprimer une app (avec versions et autorisations) |
| POST | /apps/{id}/publish |
Publier le brouillon comme version suivante |
| POST | /apps/{id}/unpublish |
Mettre hors ligne |
| GET | /apps/{id}/versions |
Versions publiées |
| POST | /apps/{id}/versions/{version}/restore |
Restaurer une version comme brouillon |
| GET | /apps/{id}/export |
Brouillon en fichier |
| GET | /apps/{id}/access |
Utilisateurs et groupes autorisés |
| PUT | /apps/{id}/access |
Définir les autorisations ({"users": [...], "groups": [...]}) |
| GET | /apps/{id}/icon |
Icône en PNG (propre ou initiale) |
| PUT | /apps/{id}/icon |
Définir l’icône propre (corps : image) |
| DELETE | /apps/{id}/icon |
Supprimer l’icône propre |
Les définitions invalides reçoivent 400 invalid_app_definition avec l’emplacement (p. ex. pages[0].elements[2]: outside the grid). Une adresse déjà prise donne 409 app_slug_taken.
Sources REST (administrateurs uniquement)
| Méthode | Chemin | Description |
|---|---|---|
| GET | /app-sources |
Lister les sources REST (sans valeurs d’en-têtes) |
| POST | /app-sources |
Créer une source (name, base_url, headers) |
| PATCH | /app-sources/{id} |
Modifier une source (headers remplace tous les en-têtes) |
| DELETE | /app-sources/{id} |
Supprimer une source |
Exécution d’une app
Hors de /api/v1 – l’app dans le navigateur l’appelle. Connexion par session (apps avec connexion) ou aucune (apps publiques) ; ?draft=1 réservé aux administrateurs.
| Méthode | Chemin | Description |
|---|---|---|
| GET | /app/<slug>/_api/app |
Définition pour le navigateur (requêtes seulement avec nom, type et paramètres, sans workflows) |
| POST | /app/<slug>/_api/query/<name> |
Exécuter une requête ({"params": {…}, "offset", "limit", "sort"} ; requêtes de téléversement : multipart/form-data avec params (JSON) et file, 50 Mo au plus) |
| GET | /app/<slug>/_api/file/<requête>/<id-fichier>[/thumbnail] |
un fichier d’une colonne de pièces jointes (ou sa miniature) – seulement si la requête de lecture nommée (liste, enregistrement, workflow) atteint la table du fichier, avec une autorisation de lecture sur exactement cette table ; sinon 404 |
| GET | /app/<slug>/manifest.webmanifest |
Manifeste de la PWA |
| GET | /app/<slug>/icon-192.png, icon-512.png |
Icônes de la PWA |
| GET | /app/<slug>/sw.js |
Service worker |
Modèles : POST /apps accepte aussi template (crud, form, dashboard) avec table (ID de table) et lang pour les textes, voir Modèles. Erreurs 400 : app_template_unknown, app_template_table_required, app_template_table_unknown, app_template_table_readonly, app_template_no_fields.