SpaceAPI

2015-03-30T12:29:28Z

Mindiell: /* Voir aussi */

Le Loop a implémenté le '''SpaceAPI''', une ressource au format JSON qui décrit l’état du hackerspace.

La ressource est disponible à l'adresse suivante : https://spaceapi.leloop.org/status.json

== SpaceAPI ==

<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>

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].

== Mise en œuvre ==

=== status.json ===

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 :

* On est en [[squat]] mais on ne change pas d'adresse tous les jours, et encore moins d'email de contact ;
* Qla porte soit ouverte ou fermée, sans sonde il est difficile de mettre l'information à jour de manière automatique ;
* Pour l'instant nous n'avons ni sonde de température, ni système de publication des événements.

=== Implémentations===

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
=== Sous-domaine ===

À l'origine, le fichier {{fichier|status.json}} était a la racine du domaine : <code><nowiki>http://leloop.org/status.json</nowiki></code>

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.

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>.

N.B. : le con de bot se fiche de la redirection, ce qui fait qu'il pourrit toujours le log du domaine principal.

Update : depuis ce 13 janvier 2013, le bot n’apparaît plus dans les logs. A suivre ?

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 ?

=== Site web ===

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

Bien entendu, patches welcome.

== Conditions d'utilisation ==

Monsieur le bot, merci de suivre ces recommandations :

* Tu devrais fournir un user-agent, pour faciliter ton identification ;
* Tu n'as pas besoin de venir plus d'une fois par jour. Si ça vient à changer, cette page sera mise à jour.

== Voir aussi ==

<s>* http://spacestatus.bastinat0r.de/#leloop : statistiques SpaceAPI pour Le Loop</s>
* http://spaceapi-stats.n39.eu/#leloop : statistiques SpaceAPI pour Le Loop
[[Category:Infrastructure]]

Le L∞p's Wiki - User contributions [en]

SpaceAPI