Journal des modifications et abandons

Cette page répertorie les versions de chaque API Fundamentum avec leur statut, les opérations abandonnées et la manière de suivre les changements. Consultez-la avant de démarrer une nouvelle intégration ou de mettre à niveau une intégration existante.

Versions de l'API

API	Version	Statut	Spécification
Public API	v1	Actuelle. Quelques opérations sont abandonnées, voir ci-dessous	`https://api.fundamentum-iot.com/v1/api/swagger.json`
Public API	v2	Actuelle	`https://api.fundamentum-iot.com/v2/api/openapi.json`
Devices API	v3	Actuelle. Utilisez-la pour tous les nouveaux travaux	`https://devices.fundamentum-iot.com/api/v3/swagger.json`
Devices API	v2	Prise en charge, non abandonnée. Aucune nouvelle fonctionnalité : les appareils en stock, les clés de provisionnement, la télémétrie HTTPS et le point de terminaison de jeton du registre n'existent que dans la v3	`https://devices.fundamentum-iot.com/api/v2/swagger.json`
Devices API	v1	Abandonnée. Migrez vers la v3	`https://devices.fundamentum-iot.com/api/v1/swagger.json`

Les versions v1 et v2 de la Public API sont complémentaires et non successives : chaque domaine se trouve dans l'une d'elles. Voir Public API.

Opérations abandonnées

Devices API v1

Toutes les routes d'appareil de la v1 sont abandonnées :

Abandonné	À utiliser à la place (v3)
`POST /api/v1/provision`	`POST /api/v3/provision`
`POST /api/v1/devices/{serial_number}/states`	Publier les états via MQTT, voir MQTT topics and message formats
`POST /api/v1/devices/{serial_number}/heartbeat`	Heartbeat via MQTT, ou `POST /api/v3/projects/{project_id}/regions/{region_id}/registries/{registry_id}/devices/{serial_number}/heartbeat`
`POST /api/v1/devices/{serial_number}/commands/{device_command_id}`	Signaler le statut de la commande via MQTT, voir MQTT topics and message formats

La v1 adresse un appareil par son seul numéro de série. La v3 l'adresse par projet, région, registre et numéro de série. Voir Devices API v3.

Public API v1

Abandonné	À utiliser à la place
`GET /v1/projects/{projectId}/actions`	`GET /v1/projects/{projectId}/registries/{registryId}/actions`
`POST /v1/projects/{projectId}/actions`	`POST /v1/projects/{projectId}/registries/{registryId}/actions`
`PUT /v1/projects/{projectId}/actions/{actionId}`	Annuler ou relancer l'action : `actions/{actionId}:cancel`, `actions/{actionId}:retry`
`GET`, `PUT /v1/projects/{projectId}/device-actions/{deviceActionId}`	`GET /v1/projects/{projectId}/devices/{deviceId}/actions`, et `devices/{deviceId}/actions/{actionId}:cancel` ou `:retry`
`GET /v1/projects/{projectId}/registries/{registryId}/device-actions`	`GET /v1/projects/{projectId}/registries/{registryId}/actions`
`GET`, `PUT /v1/projects/{projectId}/registries/{registryId}/heartbeats/config`	`GET`, `PUT /v1/projects/{projectId}/device-types/{deviceTypeId}/heartbeats/config`

Les opérations abandonnées fonctionnent toujours. Elles sont signalées par deprecated: true dans la spécification OpenAPI, et Swagger UI les affiche barrées.

Annonce des abandons

Les opérations abandonnées sont marquées deprecated dans les spécifications OpenAPI publiées, avec le remplacement dans leur description lorsqu'il en existe un.
Les changements de la CLI fun sont répertoriés dans son journal des modifications à l'adresse https://cli.fundamentum-iot.com. Exécutez fun check-update pour savoir si une version plus récente est disponible.

Changements récents

Cette section répertorie les changements notables des API, du contrat MQTT et de la CLI fun, du plus récent au plus ancien.

Date	Domaine	Changement
2026-09	CLI `fun` 0.5.3	Ajout du skill `atoms3-lite` pour le kit de démarrage AtomS3 Lite
2026-09	CLI `fun` 0.5.2	Publication des builds Windows (386). Ajout du skill `fun-api-device`. `fun install-skills` installe dans `~/.claude/skills` lorsque `~/.claude` existe
2026-09	CLI `fun` 0.5.0	Ajout de `fun install-skills`
2026-08	CLI `fun` 0.4.0	Ajout de `fun api` (toute la Public API, générée à partir des spécifications), de la complétion du shell et de `fun config dir`