Publicité
7. Interactions avec l'extérieur
Il existe deux possibilités pour utiliser l'API Yoctopuce enmode callback. La première, disponible en
PHP, Java et Node.JS est basée sur des connections en pur HTTP. Le YoctoHub-Wireless-g poste
l'intégralité de son état au serveur, et reçoit en retour des commandes du script sur le serveur. Ce
fonctionnement implique quelques limitations: les intéractions complexes, comme la récupération de
données depuis l'enregistreur de données sur les capteurs, ne sont pas possible.
Le deuxième mode fonctionnement de l'API par callback est l'utilisation des callbacks WebSocket.
Ce mode est disponible uniquement avec les serveurs Java et Node.JS. Les WebSockets sont une
extension standard de HTTP, qui permet l'établissement d'une liaison bidirectionnelle complète sur
une liaison HTTP. Lorsqu'un script serveur est connecté à un YoctoHub-Wireless-g au travers d'un
callback WebSocket, l'API Yoctopuce peut être utilisée sans la moindre limitation.
7.9. User defined callback
Les "User defined callback" vous permettent de personnaliser la manière dont votre YoctoHub-
Wireless-g va interagir avec un site Web externe. Vous avez besoin de définir l'URL du serveur Web
sur lequel le YoctoHub-Wireless-g va poster l'état de ses devices. Notez que seul le protocole HTTP
est supporté (pas de HTTPS).
Si vous désirez protéger votre script de callback, vous pouvez configurer un contrôle d'accès HTTP
standard sur le serveur Web. Le YoctoHub-Wireless-g sait comment gérer les méthodes standard
d'identification de HTTP: indiquez simplement le nom d'utilisateur et le mot de passe nécessaires
pour accéder à la page. Il est possible d'utiliser la méthode "Basic" aussi bien que la méthode
"Digest", mais il est recommandé d'utiliser la méthode "Digest", car elle est basée sur un protocole
de question-réponse qui évite la transmission du mot de passe sur le réseau et évite aussi les copies
d'autorisation.
Le YoctoHub-Wireless-g poste avec la méthode POST les valeurs notifiées
régulier, et à chaque fois qu'une de ces valeurs change de manière significative. Vous pouvez
changer les délais d'attente entre les posts.
Tests
Afin de vous permettre de déboguer le processus, le YoctoHub-Wireless-g vous permet de visualiser
la réponse au callback envoyé par le serveur Web. Cliquez simplement sur le bouton test une fois
que vous avez renseigné tous les champs. Si le résultat vous paraît satisfaisant, fermez la fenêtre de
debug, et cliquez sur Ok.
5
Les valeurs notifiées sont celles que vous voyez quand vous cliquez sur show functions dans l'interface principale du
YoctoHub-Wireless-g .
28
La fenêtre de configurations des callbacks
5
des modules à intervalle
www.yoctopuce.com
Publicité
Chapitres
