Il vous est possible de convertir instantanément les unités d'une métrique directement depuis les modules de IO-base (Explorer, IndaBoard, API..).
Pour toute métrique ayant été configurée au préalable, vous pouvez convertir ses valeurs à la volée dans une unité différente de celle affichée au départ.
Dans Explorer
Cette option est directement accessible depuis l'écran de configuration des courbes :
Dans IndaBoard
De la même manière, IndaBoard vous permet de sélectionner une autre unité pour une conversion dynamique et immédiate, dans la page d'édition des composants.
En utilisant l'API
Une fois la conversion d'unités configurée sur une métrique, vous pouvez l'exploiter directement lors de vos appels API, notamment depuis la Console API.
La conversion s'effectue en ajoutant le paramètre targetUnit dans le corps de votre requête (par exemple, sur le endpoint latest).
Pour simplifier vos requêtes, des alias dynamiques sont disponibles pour faire référence aux unités que vous avez préconfigurées :
Pour l'unité cible 1, utilisez la valeur
$target_unit_1.Pour l'unité cible 2, utilisez la valeur
$target_unit_2.
En réponse, l'API retournera la valeur de la métrique directement convertie dans l'unité correspondante.
Remarque : L'API vous permet également de demander une conversion vers toute autre unité valide, même si celle-ci n'est pas définie comme une unité cible. Pour ce faire, il suffit de spécifier le nom complet de l'unité souhaitée dans le champ targetUnit.
Remarque : Si vous spécifiez une unité invalide ou incompatible avec la catégorie de la métrique (par exemple, convertir des kilogrammes en mètres), l'API retournera une erreur 422 accompagnée du message : "Target unit is invalid".
