====== Mkey+ ======


===== Utilisation des services Mkey en ligne =====
L'interface Web du service Mkey est disponible à l'adresse : http://www.identificationkey.fr/mkeyplus/mkey.html

Cette interface permet de procéder à une identification interactive à partir d'une base de connaissances sous forme d'un fichier SDD (xml).

**Vous pouvez :**
  * soit ajouter directement votre fichier sdd sur le serveur. Vous pouvez récupérer celui-ci pour faire vos tests : http://chouettes-hiboux-de-france.identificationkey.org/ChouettesetHibouxdeFrance.sdd.xml
  * soit indiquer l'url d'un fichier SDD (celle-ci doit être accessible à partir d'internet). Par exemple : http://chouettes-hiboux-de-france.identificationkey.org/ChouettesetHibouxdeFrance.sdd.xml

===== Utilisation des API REST "Mkey" et "Xperience" =====
**Les Web Services Mkey sont accessible à l'url :** http://mkey.services.identificationkey.fr

Les Webs services retournent des objects JSON de type key : 'value'.

===== Tester si les services fonctionnent =====
Exemple : http://mkey.services.identificationkey.fr/identification

Réponse :
<code>Available services : 'getRemainingItemsAndDescriptorsUsingIDs, getDescription, getDescriptiveData, removeSDD, getSimilarityMap, getSimilarityMapForRemainingItem, changeDescriptionHistory'
</code>

**Test du service '/identification/getDescriptiveData**'

__Ce service prend au moins 2 parametres. L'url du fichier sdd et le poid global :__

  * sddURL : http://chouettes-hiboux-de-france.identificationkey.org/ChouettesetHibouxdeFrance.sdd.xml
  * withGlobalWeigth : true

__Dans un navigateur saisir :__

http://mkey.services.identificationkey.fr/identification/getDescriptiveData?sddURL=http://chouettes-hiboux-de-france.identificationkey.org/ChouettesetHibouxdeFrance.sdd.xml&withGlobalWeigth=true

__Dans une console type shell utiliser curl :__
<code>
curl -i http://mkey.services.identificationkey.fr/identification/getDescriptiveData?sddURL=http://chouettes-hiboux-de-france.identificationkey.org/ChouettesetHibouxdeFrance.sdd.xml&withGlobalWeigth=true
</code>

===== Documentation des Web Services REST =====

[[WebServicesDetails|Détails de l'API REST Mkey]]

===== Le client Mkey  =====
Documentation du client statique "Mkey+ Static Client" réalisé pour xper => Télécharger

Les services Web étant en utlisation libre, chacun à la possibilité de développer son propre client pour interragir avec Mkey-WebServices.

__**Xperience**__

Xperience est un sous projet de Mkey. En appuis sur l'identification (Mkey), l'API xperience est un ensemble de services permettant un retour d’expériences utilisateurs. Les données générés par Xperience sont stockées dans une base de données. Elles pourront ainsi être analysés et permettre aux experts de comprendre les erreurs d'identifications.

[[WebServicesDetailsXperience|Détails de l'API REST Xperience]]