Api Heatzy
Share
Open API Heatzy
Les Open API Heatzy permettent aux développeurs d'intégrer les produits Heatzy dans leurs propres applications, plateformes domotiques ou services cloud.
Les API sont compatibles avec les produits suivants :
-
Heatzy Pilote
-
Heatzy Pilote Pro
-
Heatzy Glow
-
Heatzy Shine
Grâce à ces API HTTP, il est possible de lire l'état des équipements, d'envoyer des commandes à distance et de gérer les comptes utilisateurs.
Description
Les Open API Heatzy sont des API HTTP permettant d'intégrer les produits Heatzy dans des applications, des box domotiques ou des services cloud tiers.
Elles sont déjà utilisées par plusieurs plateformes reconnues telles que Home Assistant, Jeedom et Homey, et peuvent également être intégrées à toute autre solution domotique ou logicielle capable d'effectuer des requêtes HTTP.
Les API sont compatibles avec les produits suivants :
-
Heatzy Pilote
-
Heatzy Pilote Pro
-
Heatzy Glow
-
Heatzy Shine
L'authentification s'effectue en deux étapes :
-
connexion avec une adresse e-mail et un mot de passe ;
-
récupération d'un token d'authentification utilisé pour toutes les requêtes suivantes.
Les API permettent notamment de :
-
lire l'état des produits (mode de fonctionnement, température, état des sorties, etc. selon le produit) ;
-
envoyer des commandes à distance ;
-
récupérer les informations du compte utilisateur ;
-
gérer les équipements associés au compte.
Authentification
Login
La première étape consiste à authentifier l'utilisateur.
Requête
POST https://euapi.gizwits.com/app/login
{
"username": "example@email.com",
"password": "********"
}
Réponse du serveur
La réponse contient un token d'authentification.
Token
Le token doit ensuite être transmis dans les headers HTTP de toutes les requêtes API suivantes afin d'authentifier l'utilisateur.
Liens utiles
Documentation complète des API
La documentation officielle est disponible sur Postman :
https://documenter.getpostman.com/view/10809108/SzYXYfP6?version=latest
Documentation des Data Points
La documentation des Data Points de chaque produit est disponible ici :
https://drive.google.com/drive/folders/1YTAQ6UrZL1XGrcvnl4K0LAGnosYKJ-KC