• Récupération des données du dispositif à l'aide de l'API REST
SCU n'a intrinsèquement pas de registres statiques pour stocker les informations provenant des
dispositifs intégrés en aval, SCU agit donc comme un routeur dirigeant les requêtes vers les dispositifs.
Par conséquent, l'intégrateur doit avoir les cartes de tous les dispositifs connectés. L'ID et les adresses
d'enregistrement de tous les dispositifs connectés à la SCU pour les intégrer peuvent être récupérés à
l'aide de l'API REST. Ce chapitre explique en détail la procédure étape par étape pour télécharger l'adresse
du registre, les détails (toutes les métadonnées) à l'aide de l'API REST.
1. Une application gratuite comme Postman (téléchargée non via un serveur Web) https://www.
postman.com/for par exemple ou similaire est nécessaire pour lancer la requête de données à l'aide
de l'API REST.
2. À l'intérieur des espaces de travail de l'application : l'utilisateur peut commencer à l'aide de la requête
GET.
3. Dans l'URL : l'utilisateur doit mentionner https://(ADRESSE IP DU DISPOSITIF) : 8000/api/v1/
metadata.
4. Comme étape suivante, à l'intérieur de la section en-têtes : l'utilisateur est censé remplir les détails de
la touche et de la valeur comme suit :
• Touche : Autorisation
• Valeur : Jeton généré à partir du serveur Web.
• Pour générer le jeton à l'intérieur du serveur Web SCU, accéder à la Configuration du
système>Communication>API Rest, copier le jeton et le coller dans la section des valeurs de
postman/de toute autre application. Pour obtenir le jeton à l'intérieur du serveur Web SCU,
accéder à la Configuration du système>Communication>API Rest, copier le jeton et le coller dans
la section des valeurs de postman/de toute autre application. Si vous générez un nouvel ID de
jeton, il doit être enregistré en appuyant sur le bouton « Appliquer » et seul un nouveau jeton
pourra être utilisé pour interroger les données.
5. En utilisant ces détails, vous pouvez interroger le point de terminaison de l'API Rest SCU200. La
réponse de chaque point de terminaison est au format JSON, il est possible de copier ou d'enregistrer
la réponse pour un traitement ultérieur. La lecture des dispositifs à partir du point de terminaison
de métadonnées est nécessaire pour connaître l'object_id exact pour chaque dispositif, qui peut être
utilisé ultérieurement pour interroger des valeurs en ligne/historiques ou écrire dans un registre de
dispositif spécifique.
SCU200 SYSTÈME DE GESTION DE L'ÉNERGIE INSITE
73