API et OpenJabNab

Bonjour,


J'arrive à me dépatouiller avec mon Nabz en utilisant l'api par le serveur WIZZ, voire directement par l'api "Violet" sur openjabnab.

Je ne parviens pas à utiliser openjabnab directement par ses commandes api
Je viens de passer un bon moment à chercher mais sans succès.
J'aimerais un exemple concret de commande pour envoyer un texte au plugin TTS d'openjabnab ...

Je sais déjà chercher mon token par http://openjabnab.fr/ojn_api/accounts/auth?login=xxx&pass=yyyy

Je devrais donc simplement pouvoir envoyer:
http://openjabnab.fr/ojn_api/bunny/xxxxxxxxxxx/tts/say('Je suis vivante')?token=NNNNNNNNNNNNNNN

mais j'obtiens juste "Access denied to this bunny".

Je pense qu'un exemple à copier-coller me sauverait, merci !

J'ai déjà répondu par mail, mais je vais le faire içi pour tout le monde, et en détaillant un peu.

Pour utiliser une commande API de openJabNab, il faut utiliser la syntaxe suivante :

http://SERVER/ojn_api/bunny/ADRESSEMAC/PLUGIN/FONCTION?PARAMS&TOKEN

Tout ce qui est en majuscules est à remplacer.
SERVER, c'est le nom d'hote du serveur (openjabnab.fr pour le mien)
ADRESSEMAC, je vous laisse deviner
PLUGIN, c'est le nom "court" du plugin
FONCTION, c'est une des fonctions qu'on eut trouver soit dans le code source, soit (en partie) sur mon wiki
PARAMS, c'est la liste des paramètres envoyés, comme dans une url ( p1=blah&p2=blah&p3=blah...), donc avec les caractères spéciaux encodés (un espace codé par un + par exemple)
TOKEN, c'est token=VOTRETOKENDESESSION

le token de session, c'est celui récupéré en faisant une authentification sur le serveur.

Un grand merci à Pixel pour cette réponse rapide, j'espère que tu auras le temps de compléter un jour ton wiki avec des exemples, vraiment la syntaxe c'est toujours plus simple en copiant /collant..

Je suis bien arrivé à utiliser le plugin tts en faisant:
http://openjabnab.fr/ojn_api/bunny/xxxxxxxxxxx/tts/say?text=Je+suis+vivante&token=NNNNNNNNNNNNNNN

Maintenant je cherche pour le plugin radio et je reste bloqué sur:
http://openjabnab.fr/ojn_api/bunny/xxxxxxxxxxx/webradio/playurl?url=http://82.242.213.120:8082/Nabaztag/mp3/LittleWing.mp3&token=NNNNNNNNNNNNNNN
qui ne me donne rien du tout, alors que le serveur répond pourtant "Now streaming".
J'ai, bien sur essayé cette url dans (la belle) interface et ca marche très bien.

La prochaine étape sera la chorégraphie, j'apprécie beaucoup que l'interface WIZZ, fasse clignoter et bouger pendant le tts et le mp3, peut-être peux-tu me mettre sur la voie dès maintenant ?

Je reste très admiratif de tout ce travail qui nous permet d'utiliser nos Nabz ressucités

Bonjour,

comme ouifette, je suis intéressé par l'API.
En cherchant, je suis tombé sur http://ojnwiki.psnet.fr/commandes_api qui donne une liste plutot exhaustive des appels API possibles, mais pas comment s'en servir

Ta réponse est très claire, Pixel du Rezo, par contre, je ne sais pas où trouver le token. Si je comprends bien, il s'agit d'une variable de session ? Y a t il un rapport avec le VioletAPIToken ?

Je cherche un moyen d'envoyer des messages / lumières sur mon nabaztag. L'api par URL http est exactement ce qu'il me faut.

le VioletAPIToken est utilisé pour les commandes de l'API "violet".
le token qu'il faut dans les url du style ojn_api/bunny/MAC/plugin/fonction, c'est effectivement une variable de session, que l'on obtient en se connectant au serveur.

merci pour ta réponse rapide

Ok j'ai trouvé $_SESSION['token']. Le seul moyen que j'ai trouvé pour la récupérer est de faire un echo de cette variable sur la page api.php
(J'a installé ma propre instance locale de ojn)

Citation :

le VioletAPIToken est utilisé pour les commandes de l'API "violet".

Cette API est documentée quelque part ? Est il possible de l'utiliser depuis un programme tierce ?

Citation :

le token qu'il faut dans les url du style ojn_api/bunny/MAC/plugin/fonction, c'est effectivement une variable de session, que l'on obtient en se connectant au serveur.

Comment un programme tierce peut l'implémenter ? Est il possible de faire en sorte que le VioletAPIToken puisse servir de token ?

Non, le VioletAPIToken ne peut pas remplacer le token (sauf peut-etre sur ton propre serveur avec qq changements dans le code, mais sur des serveurs avec du monde, ce n'est pas envisageable... question de sécurité)
Le VioletAPItoken est propre à chaque lapin, et ne change jamais (sauf si on le force). Le token change à chaque session.

La doc de l'API violet doit se trouver dans les archives de google... (perso, je ne m'en sers pas puisque je peux tout faire via openJabNab.

Les deux API (violet et OJN) peuvent etre utilisées dans des programmes tierces sans soucis...
pour le token, il se récupère en faisant un appel /ojn_api/accounts/auth?login=TOTO&pass=TATA

Super ! C'est ce qu'il me faut !

Je fais donc dans 1 premier temps une recup du token via ojn_api/accounts/auth dont je me servirai pour envoyer un message. Merci

Est il possible de setter une couleur spécifique par LED via l'API ?

Par exemple : un serveur check des mail, s'il y en a pas : led verte / orange s'il y en a quelques uns / rouge s'il y en a beaucoup. une autre LED pourrait servir à twitter, facebook ...

En l'état, tu ne peux pas.
Tu peux envoyer des chorégraphies, mais c'est uniquement du "one shot".
Si tu veux le même fonctionnement que la météo par LED, il faut attendre un peu. Je suis en train de travailler à un système de chorégraphies "systèmes personnalisées"...

L'autre solution, mais dont je ne suis pas vraiment fan : faire le bourrin, et envoyer la chorégraphie toute les minutes... En activant un tel système chaque minute pendant 10h par jour (ce qui me semble peu), cela fait tout de même 600 appels par jour. Si chacun fait ça... je te laisse faire le calcul.. j'ai en ce moment plus de 300 lapins sur le serveur... on est donc à 180000 appels d'api par jour, juste pour les mails. Si on rajoute Twitter, facebook, etc... je te laisse faire le calcul.. mais à ce rythme, la gratuité de mon serveur ne pourra pas durer :-(
Ou alors, je serais dans l'obligation de mettre des quotas d'appel API, et d'augmenter les quotas par abonnements.

Ok. Cool pour le système de chorégraphie en préparation ;-) Tiens moi au courant :p

J'ai lu sur ce forum beaucoup de discussion autour du sujet des chorégraphies. Notamment avec des chaines du style "chor=1000,1,led,1,255,0,0,2,led,2,255,0,0,3,led,3,255,0,0,57,led,1,0,0,0,58,led,2,0,0,0,59,led,3,0,0,0"
Comment on les envoie au lapin ?

Merci pour tes réponses.

Cela s'envoie avec l'API "violet", et c'est ce dont je parlais juste au dessus : c'est des chorés one shot.. donc ca ne reste pas, à moins de les relancer tout le temps..

l'appel API se fait avec le VioletApiToken. voici quelques exemples :

http://openjabnab.fr/vl/FR/api.jsp?sn=MAC&token=VIOLETAPITOKEN&chor=20,0,motor,1,63,0,0,0,motor,0,11,0,1,1,led,3,154,59,211,2,led,5,101,52,88,3,led,4,54,64,141,4,led,4,210,177,13,5,led,5,254,136,42,6,led,1,24,47,113,7,led,2,9,151,180,8,led,5,134,95,234,9,led,3,46,7 8,86,10,led,5,138,43,53,11,led,1,230,216,205,12,led,0,235,180,225,13...

http://openjabnab.fr/vl/FR/api.jsp?sn=MAC&token=VIOLETAPITOKEN&chor=10%2C1%2Cled%2C1%2C0%2C0%2C0%2C2%2Cled%2C2%2C0%2C0%2C0%2C3%2Cled%2C3%2C0%2C0%2C0%2C4%2Cled%2C1%2C150%2C150%2C0%2C5%2Cled%2C2%2C255%2C255%2C0%2C6%2Cled%2C3%2C150....
On notera la différence d'encodage.. les 2 sont acceptés.

De plus, dans l'url, ca peut etre indifférement (du moins sur mon serveur) /vl/FR/api.jsp ou /ojn/FR/api.jsp

Impec ! cela fonctionne en local avec l'adresse ojn/FR/api.jsp

Tres colorée la deuxième, j'aime beaucoup :-p

Pour info, j'ai trouvé une vieille description de l'api violet ici : http://www.harfangdesneiges.free.fr/?article23/

Citation :

2. Commander les oreilles

Pour commander les oreilles, on utilise une série de valeurs séparées par des virgules.
Les commandes sont les suivantes :
Première valeur : "l'heure" de l'action, '0' si c'est la première commande
Deuxième valeur : 'motor', pour bouger une oreille
Troisième valeur : commande des oreilles :
'1' pour commander l'oreille gauche
'0' pour commander l'oreille droite
Quatrième valeur : angle de l'oreille, compris entre 0 et 180
Cinquième valeur : inutilisée, mettre à '0'
Sixième valeur : sens de rotation des oreilles
'1' : sens horaire : haut->arrière->bas->face->haut...
'0' : sens antihoraire : haut->face->bas->arrière->haut...
Exemple d'une commande qui tourne l'oreille gauche dans le sens antihoraire avec un angle de 20°, à "l'heure" 0 :

0,motor,1,20,0,0
3. Commander les DEL

Pour commander les DEL, on utilise une série de valeurs séparées par des virgules.
Les commandes sont les suivantes :
Première valeur : "l'heure" de l'action, '0' si c'est la première commande
Deuxième valeur : 'led', pour changer la couleur d'une DEL
Troisième valeur : utilisée pour définir quelle DEL vous voulez illuminer :
'0' : DEL du dessous
'1' : DEL de gauche
'2' : DEL du milieu
'3' : DEL de droite
'4' : DEL du nez du lapin
Quatrième, cinquième et sixième valeurs : la couleur en RVB, les valeurs sont comprises entre 0 et 255.
Exemple d'une commande qui met la DEL du milieu en vert, puis qui met celle de gauche en rouge, et pour finir qui éteint celle de droite :

0,led,2,0,238,0,2,led,1,250,0,0,3,led,2,0,0,0
Combiner les commandes des oreilles et des DEL

Voici comment combiner les trois actions, avec les paramètres initaux de tempo :
10,0,motor,1,20,0,0,0,led,2,0,238,0,2,led,1,250,0,0,3,led,2,0,0,0
Si vous avez bien suivi, c'est un jeu d'enfant d'envoyer la chorégraphie ainsi écrite ! Il suffit d'appeler cette URL :
http://api.nabaztag.com/vl/FR/api.jsp?sn=00039D4022DE&token=112231049046144&chor=0,led,2,0,238,0,2,led,1,250,0,0,3,led,2,0,0,0

Pixel, j'ai des problèmes aussi avec les API sur ton serveur...

voici la commande que j'utilise pour envoyer la radio NRJ sur mon lapin...

openjabnab.fr/ojn/FR/api_stream.jsp?token=8a81755a9a8450f6e8688c39ebdcd4ab&sn=0019db0003ea&urlList=http://82.242.213.120:8082/Nabaztag/mp3/LittleWing.mp3

J'ai bien un retour "WEBRADIOSENTYour webradio has been sent", ok là tout va bien.
A la 1er exécution le nez du lapin clignote bien... mais après pas de son.
et si je relance la commande, je n'ai plus rien (pas de led, pas de son)

PS pour rexave, peux-tu effacer la citation de ton message ? (il est immense...)

loloz3 a écrit:

PS pour rexave, peux-tu effacer la citation de ton message ? (il est immense...)

en fait c'est l'url de Pixel du Rezo qui est immense

Exact, je l'ai coupée.. en esperant que les interessés avaient copié cette url en version "longue"

Bonjour,

J'ai une petite question sur l'API openjabnab. De mon côté je n'ai pas de problème de fonctionnement. Je commande mon lapin à travers une box domotique et j'aimerais qu'il contribue à la simulation de présence notamment en diffusant une Webradio. Je n'ai pas de problème pour lancer la diffusion mais par contre je n'ai pas trouvé de commande pour stopper la diffusion.  La seule manière est d'appuyer sur le bouton du lapin. Ce qui embêtant quand on n'est pas là ;-).

Suis-je passer à coté d'une commande API ? Merci pour votre aide.

Manu

Salut,

D'après mes souvenirs, il n'y a pas de telle possibilité... Mais ça peut se mettre en place assez facilement... Faut juste trouver le temps

Merci pour ce retour.
D'après toi, il faudrait ajouter une commande au plugin ou bien faut il rentrer dans le firmware ?

Merci

Manu

A la reflexion, je pense que c'est déjà intégré de manière détournée.
Il faudrait essayer de lancer un streaming d'un MP3 "vide"... pas un fichier vide, mais un son d'1/10ème de seconde par exemple, sans son...

Effectivement ca semble efficace. Depuis OpenJabNab j'ai lancé une WebRadio. Puis j'ai lancé un MP3. Et effectivement il commute sur le mp3. Je vais finaliser avec un mp3 court comme tu le proposes.

Merci pour ton aide.

Manu

Bonjour,

Je voudrais utiliser l'API pour faire l'annonce de la météo. Dans les commandes du wiki, je n'ai trouvé que des associations avec les zstamps ou de la programmation. Est-ce qu'il aurait une url pour déclencher une annonce météo immédiate ?

Bonjour,

Non, aucune commande API pour déclencher la météo, mais je peux y penser pour les futures mises à jour du site.

Ce serait très chouette. Mon lapin me donne déjà l'heure et la température extérieure le matin (via ma Vera) et je voudrais compléter le bulletin par un petit point météo :-)

J'ai une autre suggestion. Vu qu'on ne peut pas modifier la couleur des leds du ventre, ca serait sympa de pouvoir changer précisément la couleur de respiration via la nouvelle api.
J'ai vu que c'était possible mais l'idéal serait de pouvoir fixer la couleur avec un appel d'API genre :

http://openjabnab.fr/ojn/FR/api.jsp?sn=XXXXXXXXXX&token=YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY&plugin=colorbreathing&function=color&color=red

Exemple d'utilisation : respiration rouge alarme activé, respiration verte alarme désactivé ...

Crois tu que c'est possible pixel ?

Je te propose d'essayer http://openjabnab.fr/ojn/FR/api.jsp?sn=XXXXXXXXXX&token=YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY&plugin=colorbreathing&function=color&arg=red

En fait.. ma doc n'est qu'une ébauche, et n'est pas terminée.
Toutes les fonctions qui attendent un paramètre, c'est "arg" ce paramètre.