API Shelly – Contrôlez les appareils via l’URL WebHook

Partager c'est aimer!

Shelly Lot de 4 interrupteurs Wi-Fi

68,00
Amazon.fr
as of septembre 15, 2022 10:11

Télécommande WiFi à 3 entrées pour interrupteur - Shelly

28,14
Amazon.fr
as of septembre 15, 2022 10:11

 

Dans cet article de blog, je vais vous montrer étape par étape comment contrôler les appareils Shelly via l’API Shelly. Nous montrerons étape par étape comment créer et utiliser l’URL de contrôle pour votre compte Shelly Cloud ou vos appareils locaux. Cette API est sécurisée et facile à utiliser, donc tout le monde peut démarrer rapidement !

Pourquoi devrait-on utiliser l’API du tout

Il existe de nombreuses raisons pour lesquelles vous devriez contrôler vos appareils domestiques intelligents Shelly via une API. La raison la plus importante est peut-être que Sécurité. Si vous utilisez une API, vous l’avez contrôler à propos de qui Accéder a la votre dispositifs a et ce qu’il peut en faire. C’est beaucoup plus sûr que de simplement donner à quelqu’un ou à un plugin qui Mot de passe pour votre compte admettre.

Une autre raison d’utiliser l’API est la Commodité. Il peut faire beaucoup Plus facile être une automatisation configurer et vos appareils via un URL pour Impôts qu’environ un application mobile ou une interface web. Cela est particulièrement vrai si vous avez plusieurs appareils de différents fabricants avoir ça peut-être pas d’interface ont ou ne prennent pas en charge toutes les fonctions.

Par exemple, je l’ai déjà utilisé pour mon projet d’ouvre-porte intelligent, le bouton Shelly et mon ordinateur d’arrosage DIY. Comme vous pouvez appeler cette URL, vous pouvez contrôler vos appareils Shelly depuis votre réseau local et les contrôler de n’importe où via le Shelly Cloud. Tout ce que vous avez à faire est de saisir une URL simple et de changer d’appareil.

Alors, commençons!

Contrôlez les appareils dans le réseau local (WLAN).

Le moyen le plus simple de contrôler vos Shellies est via le réseau local. En fait, il suffit d’appeler une simple URL, avec le contrôle du cloud (ci-dessous) le tout fonctionne un peu différemment et est plus compliqué.

Trouver l’adresse IP

Vous devez d’abord savoir quelle est l’adresse IP de votre appareil Shelly à contrôler. Connectez-vous simplement à l’interface Web via le navigateur ici, ou regardez dans l’application sous les informations sur l’appareil.

Au fait : Le nom d’hôte (nom de l’appareil) fonctionnerait également, mais l’adresse IP est plus fiable 😉

sélectionner la commande

La chose la plus importante que vous devez savoir au début : Ici vous pouvez accéder à la documentation du fabricant accès (malheureusement non disponible en allemand). Il contient toutes les informations sur la façon d’interroger, de programmer et de gérer les shellies. Mais voici les principales commandes de l’API HTTP pour modifier Shelly Gadgets que j’ai notées :

appareil mode but commande
Shelly1 / Shelly1PM allumer http://IP.from.Shelly.device/relay/0?turn=on
Shelly1 / Shelly1PM éteindre http://IP.from.Shelly.device/relay/0?turn=off
Shelly2(.5) canal 1 relais allumer http://IP.from.Shelly.device/relay/0?turn=on
Shelly2(.5) canal 1 relais éteindre http://IP.from.Shelly.device/relay/0?turn=off
Shelly2(.5) canal 2 relais allumer http://IP.from.Shelly.device/relay/1?turn=on
Shelly2(.5) canal 2 relais éteindre http://IP.from.Shelly.device/relay/1?turn=off
Shelly2(.5) scooter ouvrir http://IP.de.Shelly.device/roller/0?go=ouvrir
Shelly2(.5) scooter conclure http://IP.de.Shelly.device/roller/0?aller=fermer
Gradateur/SL allumer http://IP.from.Shelly.device/light/0?turn=on
Gradateur/SL éteindre http://IP.from.Shelly.device/light/0?turn=off
Gradateur/SL atténué à 50 % http://IP.from.Shelly.device/light/0?brightness=50

Comme vous pouvez le constater, en fonction de votre type d’appareil, de la version du firmware et des sorties, entrées ou interfaces correspondantes, il existe désormais différentes commandes de contrôle. Choisissez simplement votre appareil et une commande dans le tableau 👆.

Test de l’URL de commande

Dans mon cas, l’URL générée pour activer le Shelly Plug S ressemble à ceci :

http://192.168.1.12/relay/0?turn=on

Cela peut simplement être appelé dans le navigateur et il commute immédiatement les prises intelligentes.

Une fois la demande traitée, vous verrez une fenêtre de navigateur sage avec la réponse de l’appareil, écrite en données JSON. Ici, les Shelly vous indiquent, par exemple, que le statut de « ison » est maintenant « true », c’est-à-dire activé.

Que faire des Shellies protégés par mot de passe ?

Si vous avez sécurisé cette interface avec un nom d’utilisateur et un mot de passe, vous devez également saisir un « En-tête d’autorisation HTTP de base » révéler.

Cela ressemble à ça science des fusées, mais ce n’est pas un problème. Parce que dans navigateur lse mange En-têtes relativement simples remettre. Écrivez simplement les données d’accès devant l’adresse IP de votre appareil sous la forme :

http://nom d’utilisateur:mot de passe@adresse IP

Alors pour moi :

http://admin:supersecret@192.168.1.12/relay/0?turn=on

Soit dit en passant, vous avez exactement besoin de ces URL pour le Shelly Button en tant qu' »URL-Action » afin de pouvoir contrôler les appareils lorsque le bouton est enfoncé. Alternativement, vous pouvez également utiliser des scènes.

Contrôlez les appareils via Internet (Shelly Cloud).

Comme le contrôle via le cloud est beaucoup plus compliqué, cette approche n’est recommandée qu’aux passionnés de smart home expérimentés ou passionnés 🙂

Activer le nuage

Vous devez d’abord créer un compte Shelly Cloud ou vous connecter avec votre adresse e-mail ou votre nom d’utilisateur. Cela fonctionne à la fois dans l’application et dans le Interface Web de Shelly Cloud.

De plus, l’appareil que vous souhaitez contrôler doit bien sûr être dans le Shelly Cloud, reconnaissable au petit symbole de nuage sur l’appareil.

Découvrez la clé cloud, le serveur et l’ID de l’appareil

Ce dont vous avez encore besoin, c’est de votre clé API Cloud et du serveur sur lequel votre compte a été créé. Vous pouvez retrouver les deux dans l’application Shelly ou l’interface Web.

La clé API s’applique à tous les appareils de votre compte, tout comme le serveur.
D’ailleurs, une connexion avec e-mail et mot de passe n’est pas possible avec le cloud.

Vous avez également besoin de l’ID de l’appareil à contrôler. Ceux-ci sont également disponibles dans l’application.

Découvrir la commande cloud

Tout d’abord, il est urgent de savoir que la page de la documentation est pour une autre. Ici (lien) il y a toutes les informations et un exemple pour envoyer et recevoir des données.

dans la section communication vous pouvez déjà voir que les requêtes sont structurées différemment. Parce qu’ici va au lieu d’utiliser des paramètres d’URL au cours d’une charge utile (un corps de requête, si vous voulez), qui doit être conforme au format « application/x-www-form-urlencoded ».

Envoyer la commande à l’API cloud

L’API Cloud ne peut plus être testée aussi facilement via le navigateur, c’est pourquoi nous nous appuyons sur l’application Postmann (Télécharger) Se replier sur. Il s’agit d’une application gratuite co-développée par Google pour tester les API.

Après avoir installé l’application, suivez simplement la vidéo et faites une pause si nécessaire. N’oubliez pas également d’utiliser votre propre ID d’appareil, nom de serveur et clé API.

Comment envoyer une demande à un appareil Shelly à l’aide de Postman en langage API. Dans mon exemple à un Shelly 1.

J’espère que cet article de blog vous a été utile et vous a montré comment contrôler vos appareils Shelly avec l’API. Si vous avez des questions ou rencontrez des problèmes, n’hésitez pas à nous laisser un commentaire.

Merci pour la lecture!

Évaluer ce post
Quitter la version mobile