[API] Wizz.cc : API Unifée pour les Karotz & Nabaztag

Dernière édition par wizz.cc le Mer 27 Mar 2013 - 18:46, édité 5 fois

L' API unifiée Wizz.cc, est mise à disposition pour les développeurs Karotz & Nabaztag.

Cette API permet d'intégrer très facilement les fonctionalités de messagerie instantanée, pour les Karotz, dans les applications et les sites web.

Exemple :

Karotz : http://api.wizz.cc/?sn=Bunny&token=12345&tts=Hello+bunny.&voice=en
Nabaztag : http://api.wizz.cc/?sn=001234567899&token=abcd123&server=pixel&tts=Bonjour+mon+lapin.&voice=fr

Url : http://api.wizz.cc/
Retour : un message texte indiquant le résultat obtenu par l'api.

Paramètres :

sn : le pseudo du lapin. Pour les Karotz, c'est le pseudo indiqué lors de la configuration de l'appli Live Chat !. Pour les Nabz c'est le "serial_number" s/n à 12 cars. 0-9A-F (équivalent à l'adresse MAC). Ex: 0012345678AE.
token : un code de confidentialité pour limiter les envois non autorisés. Pour les Karotz, c'est le token indiqué lors de la configuration du Live Chat !. Pour les Nabz, activé ou pas en fonction des serveurs... (voir le panneau d'admin de votre lapin sur OJN).
server : Uniquement pour les Nabz. Depuis l'ouverture des serveurs Nabz, il faut désormais connaitre, outre le s/n, le nom du serveur qui héberge le Nabz. Actuellement : pixel | alexjd (ou nappey) | alfinium | carsso | datagutt | don | htristra | lgnap | lolodu78 | mine | nag | poupou | ticed. Cependant, il existe un annuaire central des Nabaztags que l'Api peut interroger pour récupérer automatiquement le nom du serveur associé au lapin. Donc, le plus simple est de ne pas renseigner ce paramètre, mais dans ce cas, s'assurer que le nabaztag est bien inscrit dans l'annuaire central.
check : Pour les Karotz uniquement. Vérifie si le Karotz est bien en ligne et disponible ! http://api.wizz.cc/?sn=Bunny&token=&check
tts : Le message à lire. Ne pas oublier le point '.' à la fin des phrases. http://api.wizz.cc/?sn=001234567899&token=&server=pixel&tts=Pizza+del+arte.&voice=it
voice : la voix à utiliser. Pour les Karotz, le service "Karotz" est utilisé (sans limitation apparente) avec les voix : fr | en | en | de. Pour les Nabaztag, le service de synthétisation Google (limité à 100 caractères) est utilisé avec les voix : fr | en | es | de | it.
ws_kajedo (ou twinmee ou voicemp3 pour compatibilité) : voix supplémentaires de synthèse pour le français (limité à 1.024 caractères). Dans ce cas, ne pas indiquer le paramètre voice précédent.
Voix : ~~bicool | chuchotement | darkvadoor | electra | guy_vieux | guy_voix_basse | guy_fort | guy_grave | helium | juliexp | julieEnfant | Loic | mamie | matteo | nono | papanoel | philippe | ramboo | sidoo~~.
Mars 2013 : Le service a encore changé... pour devenir TwinMee. Des voix ont disparu, d'autres sont arrivées...
Les voix utilisées sont désormais: JeanJean | Melodine | electra | Murphy | bicool | Stallone | Sorciere | Tchang | Vampire | Mafioso| sidoo | SuperHeros | actrice | Willaxxx| John
Bien respecter les majuscules/minuscules...
http://api.wizz.cc/?sn=001234567899&token=12345&server=violet&tts=Bonjour+bunny.&ws_kajedo=electra
ws_acapela : 50 voix supplémentaires de synthèse pour 25 langues différentes (limité à 1.024 caractères). Dans ce cas, ne pas indiquer les paramètres voice et ws_kajedo précédents.
Voix : Arabic : Leila - Leila (Female) | Mehdi - Mehdi (Male) | Nizar - Nizar (Male) | Nizareng - Nizar - English (Male) | Salma - Salma (Female) | Youssef - Youssef (Male). Catalan : Laia - Laia (Female). Czech : Eliska - Eliska (Female). Danish : Mette - Mette (Female) | Rasmus - Rasmus (Male). Dutch (B) : Jeroen - Jeroen (Male) | Sofie - Sofie (Female) | Zoe - Zoe (Female). Dutch (NL) : Daan - Daan (Male) | Femke - Femke (Female) | Jasmijn - Jasmijn (Female) | Max - Max (Male). English (India) : Deepa - Deepa (Female). English (UK) : Graham - Graham (Male) | Lucy - Lucy (Female) | Peter - Peter (Male) | Rachel - Rachel (Female). English (US) : Heather - Heather (Female) | Kenny - Kenny - Child (Male) | Laura - Laura (Female) | Nelly - Nelly - Child (Female) | Ryan - Ryan (Male) | Tracy - Tracy (Female). Faeroese : Sjurdur - Sjurdur (Male). Finnish : Sanna - Sanna (Female). French : Alice - Alice (Female) | Antoine - Antoine (Male) | Bruno - Bruno (Male) | Claire - Claire (Female) | Julie - Julie (Female) | Margaux - Margaux (Female). French (Canadian) : Louise - Louise (Female). German : Andreas - Andreas (Male) | Julia - Julia (Female) | Klaus - Klaus (Male) | Sarah - Sarah (Female). Greek : Dimitris - Dimitris (Male). Icelandic : Snorri - Snorri (Male). Italian : Chiara - Chiara (Female) | Fabiana - Fabiana (Female) | Vittorio - Vittorio (Male). Japanese (Q42011) : Sakura - Sakura (Female). Norwegian : Bente - Bente (Female) | Kari - Kari (Female) | Olav - Olav (Male). Polish : Ania - Ania (Female). Portuguese : Celia - Celia (Female). Portuguese (Brazil) : Marcia - Marcia (Female). Russian : Alyona - Alyona (Female). Spanish : Antonio - Antonio (Male) | Ines - Ines (Female) | Maria - Maria (Female). Spanish (North America) : Rosa - Rosa (Female). Swedish : Elin - Elin (Female) | Emil - Emil (Male) | Emma - Emma (Female) | Erik - Erik (Male). Swedish (Finland) : Samuel - Samuel (Male). Turkish : Ipek - Ipek (Female).
http://api.wizz.cc/?sn=mon_karotz&token=&server=&tts=Hello+bunny.&ws_acapela=ryan
noforge (ou novoice) : Uniquement pour les Nabz. Ne pas forger la synthèse mais transférer directement au serveur OJN. http://api.wizz.cc/?sn=mon_karotz&token=&server=&tts=Bonjour+mon+lapin.&noforge
posleft : bouger l'oreiller gauche jusqu'à la position 0 à 16. Non applicable pour les Karotz, puisque ses oreilles sont réajustées à chaque fin de session. http://api.wizz.cc/?sn=mon_karotz&token=&server=&posleft=5&posright=0
posright : bouger l'oreiller droite jusqu'à la position 0 à 16.
video : obtenir l'url du flux video mjpeg. Uniquement pour les Karotz. http://api.wizz.cc/?sn=karotz_pseudo&video
urlList : Indique un fichier mp3 à jouer. Pour les Nabaztag, possibilité d'indiquer plusieurs fichiers mp3 en les séparant par un pipe |. http://api.wizz.cc/?sn=mon_karotz&token=&server=&urlList=xxx.mp3
chor : Envoi d'une chorégraphie. Uniquement pour les Nabz. http://api.wizz.cc/?sn=001234567899&token=&server=pixel&chor=10,0,motor,1,20,0,0,0,motor,0,20,0,0,1,led,0,0,238,0
action : Uniquement pour les Nabz. Envoi d'une action. http://api.wizz.cc/?sn=001234567899&token=&server=pixel&action=10&strip
Action = 4 (Timezone) | 7 (Sleep ? yes/no) | 8 (V2) | 10 (Bunny Name) | 13 (Wake-up) | 14 (Go to bed)

plus
utf8 : Par défaut, l'API attend du texte brut et non pas de l'utf-8. Si vous encodez en utf-8 (utf8_encode()) alors ajouter le param &utf8=1 à la fin de l'url.
apiz : Si vous surchargez (par un utf8_encode()) un texte apparemment déjà encodé (souvent en provenance d'un navigateur) et que le rendu n'est pas celui escompté, tenter l'ajout du param &apiz=1 à la fin de l'url. Sinon, traitez le texte en amont avant de le renvoyer vers l'api.
silent : Uniquement pour les Nabz. Masque les infos rajoutées par Wizz (ex. [server] ) devant le message retourné par l'API. http://api.wizz.cc/?sn=mon_karotz&token=&server=&tts=Bonjour+mon+lapin.&voice=fr&silent
strip : Uniquement pour les Nabz. Enlève les tags html, xml... strip_tags() du message retourné par l'API. http://api.wizz.cc/?sn=001234567899&token=&server=pixel&tts=Bonjour+mon+lapin.&voice=fr&silent&strip
short : Uniquement pour les Nabz. Ne renvoie que la première partie, en mode texte, rsp->message de la réponse xml retourné par l'API :

Code:

<rsp><message>EARPOSITIONSENT</message><comment>Your ears command has been sent</comment></rsp>
noxml : Uniquement pour les Nabz. Transforme la réponse xml retournée par l'API en mode texte. Différent de strip, car on s'interesse ici uniquement à rsp->message et rsp->comment.

Notes :

De nombreuses voix étrangères sont testées régulièrement ainsi que de nouveaux (web)services de synthétisation... Ils apparaisent au fur et à mesure. D'autres services peuvent aussi être désactivés... Ces services de synthétisation ne sont pas entièrement garantis sur le (très) long terme, les licences d'utilisation étant pour l'instant "trial". Elles sont néanmoins remplacées au fur et à mesure des évolutions, des besoins... et des moyens. Wink

D'une façon générale, c'est l'API qui forge la synthèse, et non pas le serveur OJN. Ce qui permet d'ajouter de nombreuses voix ou variantes sans toucher à la configuration de chacun des serveurs en place...

Si aucune voix n'est passée en paramètre OU qu'une voix n'existe pas OU que la synthèse ne s'effectue pas correctement, alors le texte est transféré directement au serveur OJN comme avec le paramètre noforge.

Fonctions supplémentaires :

7 Plugin Mails : GMail+Yahoo+HotMail et Free+Orange+Sfr+BBox.
Karotz : http://api.wizz.cc/?list=select (format = xml|select|ul|ol|sep) liste les Karotz abonnés au service du Live Chat !
Nabaztag : http://api.wizz.cc/?list_ojn=select (format = xml|json|select|sep) liste les serveurs OJN recensés par l'API sous la forme d'une liste d'options.

Bonjour,
Il semble que l'api soit HS cet après midi non ?
En tant que big fan de cette api, je m'en suis aperçu très vite. Vivement que ça revienne !!

Edit de 15:12
Et bien finalement c'est ok maintenant. Je peu donc jouer à présent. Merci

Rien de particulier de mon côté...
Peut-être un pb (temporaire) de connexion/disponibilité de ton côté ou de celui de l'hébergeur...

Effectivement, après cette courte durée de dysfonctionnement, tout c'est bien passé le reste de l'après midi. La prochaine fois, j'attendrais un peu avant de poster....mais voir mon lapin sans voix me rend fou !! :-)

Bonjour,

On peut désormais gérer ses amis "Favoris" dans le Live Chat !

http://live.wizz.cc

Merci pour tout Wizz.cc nabzciao

Bonjour,

Nouveau : le flux video mjpeg désormais accessible.

1. La mise à jour de la Wizz.cc Karotz Class for Php a été mise à jour.

2. L'api unifiée aussi ! https://nabaztag.forumactif.fr/t13614-api-wizzcc-api-unifee-pour-les-karotz-nabaztag.
L'appel à la méthode video retourne une url du genre http://api.karotz.com/api/karotz/webcam?action=video&interactiveid=xxxxxxx.

Ex:

Code:: <html>
<head><title>Wizz.cc - full Php Class for Karotz API</title></head>
<body>
<?php $v = file_get_contents('http://api.wizz.cc/?sn=mon_pseudo_karotz&video'); ?>
<img src="<?= $v; ?>" border="1">
</body>
</html>

Bonjour,

Nouveau : le flux video mjpeg désormais accessible.

1. La Wizz.cc Karotz Class for Php a été mise à jour.

2. L'api unifiée aussi ! https://nabaztag.forumactif.fr/t13614-api-wizzcc-api-unifee-pour-les-karotz-nabaztag.
L'appel à la méthode video retourne une url du genre http://api.karotz.com/api/karotz/webcam?action=video&interactiveid=xxxxxxx.

Ex:

Code:: <html>
<head><title>Wizz.cc - full Php Class for Karotz API</title></head>
<body>
<?php $v = file_get_contents('http://api.wizz.cc/?sn=mon_pseudo_karotz&video'); ?>
<img src="<?= $v; ?>" border="1">
</body>
</html>

NB: Prévoir un bouton pour fermer la session.... yellownabzhappy

Bientôt disponible dans le Live Chat !

Merci beaucoup pour cette API.

Je rencontre un problème analogue qu'avec l'API Karotz de base : diffuser un message dans sa globalité. Souvent le message est tronqué avant la fin.

J'ai tenté d'ajouter des "... " à la fin mais cela n'est pas très fiables, comment faites vous ?

Bonjour à tous,

Le problème est toujours présent, j'ai fait des tests avec différentes voix et les messages sont souvent tronqués.
Suis je le seul à avoir le problème ?

Merci d'avance

Olfax

Code:: [ { "id": "1", "ownerId": "1", "baratinooId": "JeanJean", "name": "Régis Tabernak", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/canadien.mp3" }, { "id": "4", "ownerId": "2", "baratinooId": "Melodine", "name": "Lady Blabla", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/diva.mp3" }, { "id": "5", "ownerId": "13", "baratinooId": "electra", "name": "Lovely Megan", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/geraldine.mp3" }, { "id": "3", "ownerId": "4", "baratinooId": "Murphy", "name": "Barack", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/obama.mp3" }, { "id": "2", "ownerId": "5", "baratinooId": "bicool", "name": "King Stone", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/rasta.mp3" }, { "id": "6", "ownerId": "6", "baratinooId": "Stallone", "name": "Silverster", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/stalone.mp3" }, { "id": "7", "ownerId": "7", "baratinooId": "Sorciere", "name": "Maggie Noire", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/sorciere.mp3" }, { "id": "8", "ownerId": "8", "baratinooId": "Tchang", "name": "Jacky Lee", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/chinois.mp3" }, { "id": "9", "ownerId": "9", "baratinooId": "Vampire", "name": "Edouardo", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/vampire.mp3" }, { "id": "11", "ownerId": "11", "baratinooId": "Mafioso", "name": "Al Macaroni", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/mafieu.mp3" }, { "id": "12", "ownerId": "12", "baratinooId": "sidoo", "name": "Armand Lalouze", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/nerd.mp3" }, { "id": "13", "ownerId": null, "baratinooId": "electra", "name": "Lovely Gogo", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/gogo.mp3" }, { "id": "14", "ownerId": "14", "baratinooId": "SuperHeros", "name": "Super Tonnerre", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/superHeroe.mp3" }, { "id": "15", "ownerId": "15", "baratinooId": "actrice", "name": "Audrey Toutou", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/actrice.mp3" }, { "id": "16", "ownerId": "16", "baratinooId": "Willaxxx", "name": "BOOBi", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/rappeur.mp3" }, { "id": "17", "ownerId": "17", "baratinooId": "John", "name": "Choc Morris", "sampleURL": "http://www.twinmee.com/sites/default/files/share/ressources/voices/samples/chuck.mp3" } ]

» [OJN] Wizz.cc : API Unifiée pour les Nabaztag & Karotz
» du son nabaztag tag pour le karotz !!!!
» [Wizz.cc] Nabaztag Contrôleur pour iPhone iPad Android BB... Mac & Pc
» [API] Wizz.cc : API Karotz - premiers pas...
» [Kontroller] Wizz.cc : Karotz Kontroller l'appli web pour smartphone/xpad/pc/mac...