Table des Matières
Publicité
7. Interactions avec l'extérieur
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-Ethernet au travers d'un
callback WebSocket, l'API Yoctopuce peut être utilisée sans la moindre limitation.
L'application web GatewayHub, disponible sur le site de Yoctopuce, utilise cette technologie de
callback Websocket pour permettre un accès à distance au YoctoHub-Ethernet, même à travers un
filtre NAT ou un pare-feu. Pour plus d'informations, référez-vous au blog de Yoctopuce
7.9. User defined callback
Les "User defined callback" vous permettent de personnaliser la manière dont votre YoctoHub-
Ethernet va interagir avec un site Web externe. Vous avez besoin de définir l'URL du serveur Web
sur lequel le YoctoHub-Ethernet 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-Ethernet 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-Ethernet 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-Ethernet 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.
Formats
Les valeurs sont postées sous une des formes suivantes:
4
http://www.yoctopuce.com/FR/article/une-passerelle-pour-acceder-aux-yoctohubs-a-distance
5
Les valeurs notifiées sont celles que vous voyez quand vous cliquez sur show functions dans l'interface principale du
YoctoHub-Ethernet .
28
La fenêtre de configurations des callbacks
4
.
5
des modules à intervalle
www.yoctopuce.com
Publicité
Table des Matières
