Connecter le matériel (API)

Utiliser l'API Kinvent depuis la boîte à outils1 min 25

Configurer l'API Kinvent1 min

Cet onglet relie le logiciel aux comptes que vous possédez déjà chez les fabricants de matériel. Une fois la liaison établie, vous retrouvez dans la Boite à outils les tests réalisés avec leurs propres applications, sans les ressaisir. Trois blocs se suivent : Connexion VALD, Connexion Kinvent et Connexion Garmin.

Avant de commencer

Un compte actif chez le fabricant, avec ses identifiants sous la main.
Pour VALD, la clé d’accès est fournie par le fabricant : identifiant, mot de passe et identifiant d’organisation. Ils ne se devinent pas, demandez-les à votre contact chez eux.
Ces réglages valent pour le cabinet entier, pas pour un poste. Vous ne les saisissez qu’une fois.

Connecter Kinvent

Ouvrez Paramètres dans le menu de gauche, puis l’onglet API matériel, dans le groupe Outils connectés.
Dans le bloc Connexion Kinvent, renseignez Email Kinvent et Mot de passe Kinvent — ceux de votre compte chez le fabricant.
Laissez le champ URL de base API tel quel. La consigne affichée est claire : on n’y touche que sur instruction du fabricant.
Cliquez sur Tester la connexion. La première fois, le logiciel enregistre puis teste dans la foulée.
Vérifiez le bandeau en haut du bloc. Connexion Kinvent opérationnelle, suivi de la date du dernier test réussi, signifie que tout est en place.

Connecter VALD

Le bloc Connexion VALD fonctionne de la même façon, avec quatre champs : Identifiant API (Client ID), Mot de passe API (Client Secret), Identifiant organisation (Tenant ID) et Région VALD. La région se choisit dans une liste — Europe-West (euw), US-East (use) ou Australia-East (aue) — et doit correspondre à celle de votre compte, sinon aucun test ne remonte.

Cliquez sur Enregistrer, puis sur Tester la connexion, qui n’apparaît qu’une fois la configuration enregistrée.

Le bloc Garmin

Connexion Garmin ne se règle pas depuis cet écran : il s’affiche pour information. Vous y lisez l’état de chacun des trois services — Activity API, Health API et Training API —, les adresses à déclarer côté fabricant, chacune avec son bouton de copie, et la liste Patients liés à un compte Garmin, qui rappelle pour chacun la date de liaison et celle de la dernière synchronisation. Tant qu’aucun patient n’est relié, la mention « Aucun patient lié pour l’instant. » s’affiche.

Si un service apparaît comme non configuré, la mise en place se fait côté serveur : contactez le SAV.

Modifier ou couper une liaison

Les identifiants déjà enregistrés ne sont jamais réaffichés. Les champs reviennent donc vides, avec la mention « laisser vide pour conserver l’actuel » : ne remplissez que ce que vous voulez changer, puis Enregistrer.

Pour couper une liaison, cliquez sur Supprimer la configuration, en bas à gauche du bloc. Le logiciel demande confirmation et rappelle que les données ne seront plus accessibles depuis la Boite à outils.

Pièges fréquents

« Échec du dernier test de connexion » : le bandeau rouge donne le motif renvoyé par le fabricant. Neuf fois sur dix, un identifiant ou un mot de passe est erroné — ressaisissez les deux entièrement.
Un bandeau orange vous invite à tester : il reste affiché tant que Tester la connexion n’a pas été lancé. Enregistrer ne vérifie rien.
Le bouton Enregistrer reste inactif : pour une première configuration, tous les champs obligatoires doivent être remplis. Ensuite, il ne s’active que si vous avez modifié quelque chose.
La connexion marchait, elle échoue aujourd’hui : vous avez sans doute changé de mot de passe chez le fabricant. Saisissez le nouveau ici, puis retestez.
VALD répond mais aucun test n’apparaît : vérifiez la Région VALD et l’Identifiant organisation (Tenant ID), qui filtrent les tests vous appartenant.