Heatzy

View Original

Heatzy OpenAPI 2

Chapitre 3 : Recevoir les donnees d’un pilote

Récap :

Dans le chapitre précédent, on a vu comment s’identifier auprès du serveur à l’aide d’une requête POST et comment demander des informations sur nos appareils à l’aide d’une requête GET. À présent, nous allons voir comment envoyer des ordres à un pilote.

Sommaire :
1/ Avant de commencer
2/ Envoi de la requête
3/ Réception des données pour un pilote première génération
4/ Réception des données pour un pilote 2ème ou 3ème génération

1/ Avant de commencer

Préparation des paramètres

Pour recevoir les données d’un pilote, on a besoin des mêmes informations que pour envoyer un ordre. Si vous avez un doute ou n’êtes pas sûr, vous pouvez toujours revenir en arrière sur les précédents chapitres du tutoriel pour avoir des explications détaillées de ces paramètres.

  • X-Gizwits-Application-Id : c70a66ff039d41b4a220e198b0fcc8b3

  • X-Gizwits-User-token : token obtenu précédemment

  • did : Device ID obtenu précédemment

2/ Envoi de la requête

On va envoyer une requête GET à l’adresse suivante : https://euapi.gizwits.com/app/devdata/{did}/latest. N’oubliez pas de remplacer la valeur {did} par votre device ID.
Ensuite dans les Headers, renseignez l’Application ID et votre token utilisateur.

3/ Réponse du serveur

Réception des données

Après avoir envoyé votre requête, et si tous les paramètres sont corrects vous devriez vous retrouver avec ce résultat :

Ici, on ne montre qu’une partie de la réponse parce qu’il y a beaucoup de paramètres de réponse, mais pas de panique, on va vous expliquer lesquels peuvent vous servir.

Interprétation des données

Le premier paramètre à regarder est mode, il peut renvoyer quatre valeurs différentes : cftecofro et stop. Ces valeurs correspondent respectivement aux modes : confort, éco, hors-gel et off.

Ensuite deux autres paramètres peuvent vous intéresser : derog_mode et derog_time. Ces valeurs vont vous indiquer si le mode vacances est activé ou non sur le pilote (0 ou 1) et combien de temps (en jours).

Un autre paramètre intéressant est lock_switch pour savoir si votre pilote est en mode lock ou pas (0 ou 1). Et enfin timer_switch qui vous indique si la programmation est activée ou pas (0 ou 1).

Conclusion

On termine ici sur cette requête. Nous vous conseillons d’expérimenter en changeant des paramètres devotre pilote et en mettant à jour la requête pour voir quels paramètres sont impactés.

Dans un prochain chapitre on se concentrera exclusivement sur la programmation et sur les paramètres « pX_dataY ».