L'API Rest
Accéder à la racine de l'APIl'API permet principalement de récupérer la liste des formations, avec ou sans critère de recherche, le détail d'une formation, la liste des experts, le détail d'un expert.
Les données sont distribuées aux formats json, jsonp ou xml. Dans le navigateur, les données sont visualisées au format json par défaut. Pour accéder aux données au format xml, il faut rajouter ".xml" à l'url. De même pour les formats json et jsonp
Exemple d'url d'accès aux données
Remarques
Pour les paramètres de type booléen, les valeurs suivantes sont prises en compte : yes, true, oui, vrai, no, false, non et faux. Un champ vide est assimilé à True. La casse n'a pas d'importance.
Il y 3 paramètres booléen possibles lorsqu'on utilise l'url '...trainings/select/...' : futur, insc et current_syear. (Pour le nom des paramètres, la casse compte)
Exemple d'affichage des données sur un site web tierce
L'utilitaire javascript ccJSON2HTML.js transpose les données du json au html. Cela permet de les afficher sur un autre site web.
Ci dessous, 2 exemples à partir des données MaiMoSiNE. Pour voir le code source, il faut cliquer sur le lien puis afficher le code source via le navigateur.
- Afficher la liste des 10 dernières formations : training-list.html
- Afficher la liste des experts : expert-list.html
Flux Rss
Flux existants
Les flux rss distribués par maimosine-info sont les suivants :
- Les 10 derniers séminaires (http://maimosine-info.imag.fr//feed/training/seminar)
- Les formations à venir ou en cours (http://maimosine-info.imag.fr//feed/training/futur)
- Les 10 dernières formations pour lesquelles le cadre est maimosine (http://maimosine-info.imag.fr//feed/training/frame/maimosine)
Dans le cas du dernier flux, on peut remplacer "maimosine" par le nom ou l'id d'un autre cadre, et avoir ainsi la liste des dernières formations pour un cadre donné
Comment afficher ces flux sur un site
Pour afficher ces flux sur un site, on peut utiliser un code javascript et une css fournis par maimosine-info. Le tout, ainsi qu'un exemple se trouve là: Affichage des flux Rss
Pour cela, il faut inclure dans le code html coté client les lignes suivantes:
<link href="http://maimosine-info.imag.fr/rssFeed/ccRssFeed.css" type="text/css" rel="stylesheet" />
<script type="text/javascript" src="https://www.google.com/jsapi"></script>
<script type="text/javascript" src="http://maimosine-info.imag.fr/rssFeed/ccRssFeed.js"></script>
<script type="text/javascript">
new displayRss("http://maimosine-info.imag.fr/feed/training/frame/maimosine/", 10,"title,category")
</script>
On pourra bien sur remplacer la css de maimosine - donnée à titre d'exemple - par une css locale.
Ce qu'on peut parametrer via la fonction displayRss :
- Afficher ou non le titre du feed, ainsi que la catégorie des items (=type de formation). Pour cela, il faut enlever/rajouter 'title' ou 'category' dans le dernier paramètre. Par exemple "" n'affichera ni l'un ni l'autre, tandis que "category" affichera les catégories mais pas le titre.
- Choisir le nombre d'items à afficher (<=10)