Api Heatzy

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 AssistantJeedom 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

Retour au blog