Afin d’intégrer mes lapins blancs dans mon système domotique, il me fallait un serveur local auquel je puisse envoyer des ordres à l’aide d’une API.
OpenJabNab est un serveur alternatif pour nabaztag qui remplie ces conditions. Vous trouverez un tutoriel d’installation sur le forum forumactif.nabaztag
Le détail de l’API d’OJN est disponible à l’adresse suivante :
http://ojnwiki.psnet.fr/commandes_api
Comment se servir de cette API ?
Prenons un exemple. On souhaite faire dire au lapin « Cacahuete ».
On va utiliser pour cela l’API « TTS »:
/ojn_api/bunny/MAC_ADDRESS/tts/say(text)
On appelle simplement en http :
http://ADRESSE/ojn_api/bunny/ADRESSEMAC/tts/say?text=Cacahuete&token=TOKEN
avec :
ADRESSE = l’adresse du serveur OJN. Ex: si vous accédez à la page d’admin via http://serveur.com/ojn_admin, ADRESSE=serveur.com
ADRESSEMAC = l’adresse MAC du lapin à appeler ou numéro de série (à trouver sous le lapin)
TOKEN = une clef d’authentification
Il nous faut donc avant un TOKEN. Pour cela, il faut faire un appel à l’API d’authentification :
http://ADRESSE/ojn_api/accounts/auth?login=LOGIN&pass=PASSWORD
avec bien entendu le LOGIN et le PASSWORD du compte lié avec le lapin à appeler.
Donc pour résumer, pour que le lapin dise « cacahuete » , cela se passe en deux temps :
- récupération du TOKEN à l’aide de l’API d’authentification
- appel de l’API TTS en passant le TOKEN en paramètre
Merci à Pixel du Rezo pour ses explications.