Aller au contenu principal

Faire des requêtes HTTP dans une scène

Dans les scènes, il est parfois pratique d'appeler une API externe afin de contrôler des périphériques pas forcément gérés par Gladys Assistant, ou pour simplement appeler un service externe sans développer un service spécifiquement pour l'occasion.

Pré-requis

Vous devez être en Gladys Assistant v4.0.3 minimum pour avoir cette fonctionnalité.

Envoyer une requête HTTP dans une scène

Dans les scènes, vous pouvez créer une action "Faire une requête HTTP", qui vous permet de faire une requête HTTP GET, POST, PATCH, PUT ou DELETE.

Vous pouvez ajouter des headers si vous en avez besoin pour l'authentification par exemple.

Action requête HTTP dans les scènes Gladys

Exemple concret: Déclencher une action IFTTT depuis une scène Gladys Assistant

Vous connaissez probablement IFTTT, un service qui permet de connecter différents services entre eux. Leur business model ayant changé récemment, il n'est possible que de créer 3 actions par compte, mais c'est amplement suffisant si vous voulez l'utiliser uniquement pour palier à un manque de Gladys par exemple.

Dans cet exemple, nous allons utiliser IFTTT pour enregistrer une valeur dans Google Sheet à chaque fois qu'une scène est appelée.

Nous allons ici envoyer un évènement "départ de la maison" à IFTTT et lui demander de logguer cet évènement dans un Google Sheet, afin de par exemple tracker vos départs de la maison.

C'est bien entendu un exemple que vous pouvez adapter selon vos besoins 😁

Configurez les Maker Webhooks dans IFTTT

Dans IFTTT, rendez-vous sur https://ifttt.com/maker_webhooks afin de configurer les Maker Webhooks.

Je vous laisse suivre le tutoriel d'IFTTT pour configure les Maker Webhook.

Normalement, après avoir configuré les Webhooks, vous devriez arriver sur une page comme cela:

IFTTT Maker Webhook

Remplacez {event} par le nom de votre event, dans mon exemple "left_home", puis copiez-collez l'URL.

Gardez l'URL pour plus tard.

Configurez le service Google Sheet dans IFTTT

Sur la page "Explore" d'IFTTT, cherchez le service "Google Sheet", et connectez votre compte Google. Cela servira pour la suite.

Créez un Applet

Recherchez le service "Webhooks" que vous avez configuré juste avant.

Cherchez Applet

Sélectionnez "Receive a web request":

Receive a webhook request

Entrez le nom de l'évènement que vous avez entré à l'étape précédente, ici "left_home":

Entrez le nom de l'évènement

Sélectionnez où vous voulez qu'IFTTT enregistre la donnée (dans quelle spreadsheet sur votre Google Drive)

Sélectionnez le dossier Google drive ou enregistrer les données

Cliquez sur "Save".

Finir l'applet IFTTT

Puis cliquez sur Finish.

Dans Gladys, créez une scène

Créez une nouvelle scène dans Gladys, puis ajoutez lui une action "Faire une requête HTTP".

Sélectionnez "Méthode: POST", puis dans URL entrez l'URL du webhook IFTTT que vous avez configuré précédemment.

Créer une action requête HTTP

Sauvegardez la scène, puis lancez-là.

Si vous vous rendez sur Google Drive, vous devriez voir un dossier "IFTTT" à la racine, contenant un dossier "MakerWebhook", ainsi que dans ce cas un dossier "let_home".

Dedans, vous trouverez un spreadsheet avec une ligne qui a enregistré le moment où vous êtes parti de la maison:

Résultat dans Google Sheet

Conclusion

Ce n'était qu'un exemple, cette action dans les scènes permet de faire des millions de choses:

  • Appeler l'API d'une autre box domotique
  • Appeler IFTTT pour contrôler n'importe quelle API : De la musique via Sonos ? Faire sonner son téléphone ? Envoyer un email ? Envoyer un tweet ?
  • Appeler l'API de Zapier pour appeler n'importe quelle API (Gmail, Calendar, Trello, et des centaines d'autres)

Bref, les possibilités sont illimitées.

Récupérer la réponse d'une requête HTTP dans les scènes

Il est possible d'utiliser la réponse d'une requête HTTP dans une scène.

Exemple avec l'API Coinbase pour récupérer le prix du Bitcoin, et envoyer le prix par message Telegram:

Continuer seulement si

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 🙂