Aller au contenu principal

HTTP API

Gladys Assistant est un serveur qui expose une API HTTP REST.

Cette API sert au frontend de Gladys, mais peut-être aussi utilisée pour faire des actions automatiquement.

Vous pouvez ainsi coder votre propre client Gladys, ou créer des petits scripts (via Node-RED, n8n) au dessus de cette API.

Note: Cette API n'est uniquement disponible que via votre réseau local (ou Gladys est disponible). Si vous voulez accéder à une API à distance, nous proposons une Open API via Gladys Plus.

Authentification

Pour récupérer un access_token, vous pouvez appeler la route de login :

curl --location --request POST 'http://GLADYS_IP_ADDRESS/api/v1/login' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"email":"<email>","password":"<password>"}'

Une fois l'access_token récupéré, il peut-être utilisé pour appeler l'API :

curl --location --request GET 'http://GLADYS_IP_ADDRESS/api/v1/device' \
--header 'Accept: application/json, text/plain, */*' \
--header 'authorization: Bearer <access_token>'

Ce qui vous retournera la liste des appareils Gladys.

Note : Attention, l'access_token est uniquement valide 24 heures. Le refresh_token est valide 30 jours et vous permet d'aller chercher un nouvel access_token en appellant la route POST /api/v1/access_token.

Documentation d'API

Vous trouverez la documentation complète de cette API sur le site: https://apidoc.gladysassistant.com/.

Rejoignez la communauté, et recevez l'actualité du projet !

Les mails sont envoyés par Pierre-Gilles Leymarie, le fondateur du projet, et vous pouvez toujours vous désinscrire à tout moment 🙂