http://wiki.leloop.org/api.php?action=feedcontributions&user=Mindiell&feedformat=atomLe L∞p's Wiki - User contributions [en]2024-03-28T08:28:48ZUser contributionsMediaWiki 1.26.2http://wiki.leloop.org/index.php?title=SpaceAPI&diff=4695SpaceAPI2015-03-30T12:29:28Z<p>Mindiell: /* Voir aussi */</p>
<hr />
<div>Le Loop a implémenté le '''SpaceAPI''', une ressource au format JSON qui décrit l’état du hackerspace.<br />
<br />
La ressource est disponible à l'adresse suivante : https://spaceapi.leloop.org/status.json<br />
<br />
== SpaceAPI ==<br />
<br />
<blockquote>The HackerSpace Status API proposes a unified syntax to publish information about a hackerspace for consumption by javascript widgets, mobile apps and other scripts or programs. The API is flexible, and allows for custom extensions.</blockquote><br />
<br />
Pour en savoir plus, on peut lire la [http://hackerspaces.nl/spaceapi/ description complète du projet], lire [https://github.com/SpaceApi le code source], en parler sur [http://lists.hackerspaces.org/mailman/listinfo/spaceapi-devel la mailing-list dédiée] ou consulter [http://spaceapi.net/directory.json le répertoire].<br />
<br />
== Mise en œuvre ==<br />
<br />
=== status.json ===<br />
<br />
Le fichier est généré à la main, avec vim, et mis à jour une fois par siècle, étant donne la stabilité des informations qu'il contient :<br />
<br />
* On est en [[squat]] mais on ne change pas d'adresse tous les jours, et encore moins d'email de contact ;<br />
* Qla porte soit ouverte ou fermée, sans sonde il est difficile de mettre l'information à jour de manière automatique ;<br />
* Pour l'instant nous n'avons ni sonde de température, ni système de publication des événements.<br />
<br />
=== Implémentations===<br />
<br />
Un [https://git.leloop.org/Edelwin/apitoolz/ répertoire] sur le Gitlab du loop a été créé pour rassembler les outils développés par les loopiot-e-s qui interagirons avec l'API<br />
=== Sous-domaine ===<br />
<br />
À l'origine, le fichier {{fichier|status.json}} était a la racine du domaine : <code><nowiki>http://leloop.org/status.json</nowiki></code><br />
<br />
En regardant les logs, on s’est aperçu qu'un bot venait chercher le fichier toutes les 25 secondes, ce qui en faisait le visiteur le plus fidèle, avec 58% des requêtes... Le bot fautif ne fournit pas d'[[wikipedia:User_agent|user-agent]], et est hébergé sur une instance Amazon EC2, ce qui rend son filtrage difficile. Le SpaceAPI a donc été déplacé sur son propre sous-domaine, ce qui permet de ne pas pourrir les logs du domaine principal, et permettra d’étudier l'utilisation de la ressource de manière séparée.<br />
<br />
Voir le [http://lists.hackerspaces.org/pipermail/discuss/2012-October/006729.html mail de ToM] sur la mailing-list <code>discuss@lists.hackerspaces.org</code>.<br />
<br />
<small>N.B. : le con de bot se fiche de la redirection, ce qui fait qu'il pourrit toujours le log du domaine principal.</small><br />
<br />
<small>Update : depuis ce 13 janvier 2013, le bot n’apparaît plus dans les logs. A suivre ?</small><br />
<br />
<small>Update : Réapparition une semaine plus tard, avec un délai de deux minutes entre chaque visite. C'est bien, mais pas top. A suivre ?</small><br />
<br />
=== Site web ===<br />
<br />
Fait selon la [[méthode Rache]] en utilisant l’éternel template de [[User:ToM|ToM]], son code source est versionné sous Git : https://github.com/LeLoop/spaceapi.leloop.org<br />
<br />
Bien entendu, patches welcome.<br />
<br />
== Conditions d'utilisation ==<br />
<br />
Monsieur le bot, merci de suivre ces recommandations :<br />
<br />
* Tu devrais fournir un user-agent, pour faciliter ton identification ;<br />
* Tu n'as pas besoin de venir plus d'une fois par jour. Si ça vient à changer, cette page sera mise à jour.<br />
<br />
== Voir aussi ==<br />
<br />
<s>* http://spacestatus.bastinat0r.de/#leloop : statistiques SpaceAPI pour Le Loop</s><br />
* http://spaceapi-stats.n39.eu/#leloop : statistiques SpaceAPI pour Le Loop<br />
[[Category:Infrastructure]]</div>Mindiell