API de mises à jour

Interface publique en lecture seule, utilisée par OpenDeskOS (OpenDesk Updater) et par opendesk.docteam.be. Réponses JSON UTF-8, CORS ouvert. Paramètre commun lang (fr par défaut, en…).

API v2 — catalogue complet

Requête	Description
`GET /api/v2/components?lang=fr&channel=stable`	Tous les composants (système, applications, thèmes, projets) : nom et description traduits, `available` = version présente dans le dépôt APT, `latest` = dernière version publiée du canal.
`GET /api/v2/components/{id}?lang=fr`	Un composant et l'historique de ses versions publiées (`releases`, de la plus récente à la plus ancienne). `channel` facultatif.
`GET /api/v2/updates?channel=stable&lang=fr&installed=…&os_version=…`	Mises à jour pour les paquets installés : `installed=paquet=version,…` (URL-encodé), `os_version` facultatif (`VERSION_ID`). Le canal `beta` inclut les stables. Renvoie `updates`, `os` et les paramètres du dépôt `apt`.

API v1 — système uniquement (compatibilité)

Requête	Description
`GET /api/latest?channel=stable&current=1.0`	Dernière version du système dans le canal (`stable` ou `beta`). Avec `current`, indique `update_available`. Ajouter `&format=env` pour une sortie `CLE=valeur` lisible en shell.
`GET /api/releases[?channel=…]`	Toutes les versions publiées du système, de la plus récente à la plus ancienne.
`GET /api/releases/{version}`	Détail d'une version du système (notes, ISO, SHA-256, traductions).
`GET /api/ping`	Renvoie `ok`. Test de connexion de l'installateur.

Exemples

Mises à jour disponibles pour deux paquets installés :

curl -s "https://opendesk-updates.docteam.be/api/v2/updates?lang=fr&installed=opendeskos-minimal%3D1.0,opendesk-settings%3D1.0.0"

Dernière version du système, format shell :

curl -s "https://opendesk-updates.docteam.be/api/latest?current=1.0&format=env"

Les versions sont comparées comme le fait dpkg. Une mise à jour n'est annoncée que si la version est déjà installable depuis le dépôt APT.

Dépôt APT

Les paquets OpenDeskOS sont publiés dans un dépôt APT signé. Sur OpenDeskOS, il est configuré par le paquet opendeskos-archive-keyring.

/etc/apt/sources.list.d/opendeskos.sources

Types: deb
URIs: https://opendesk-updates.docteam.be/apt
Suites: trixie
Components: main
Signed-By: /usr/share/keyrings/opendeskos-archive-keyring.gpg

Clé publique : /apt/opendeskos-archive-keyring.gpg