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.