Difference between revisions of "SpaceAPI"

Latest revision as of 13:08, 7 July 2015

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

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.

Pour en savoir plus, on peut lire la description complète du projet, lire le code source, en parler sur la mailing-list dédiée ou consulter 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 ;
• Que la 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.

Voir aussi : Le projet de la sonnette et celui de l'indicateur de présence.

Implémentations

Un 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 status.json était a la racine du domaine : http://leloop.org/status.json

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'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 mail de ToM sur la mailing-list discuss@lists.hackerspaces.org.

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

• http://spaceapi-stats.n39.eu/#leloop : statistiques SpaceAPI pour Le Loop