Utilisation de l’API de OpenJabNab

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 »:

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 :

  1. récupération du TOKEN à l’aide de l’API d’authentification
  2. appel de l’API TTS en passant le TOKEN en paramètre

 

Merci à Pixel du Rezo pour ses explications.

 

 

 

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *