🎂Introduction🎂
Il y a tout juste un an, le 1er Août 2020, le Gouvernement de Nouvelle-Calédonie lançait officiellement sa plateforme Open Data :
Maxime Bollengier@maxbollengierL'aventure open data débute en Nouvelle-Calédonie avec la sortie de data.gouv.nc 🎉 Merci @Etalab en particulier @Mathilde_Hg et @RomainTales pour vos conseils et votre soutien. Bravo @HouySy pour le travail réalisé 👏 cc @GouvNC @opendatasoft_fr08:17 AM - 01 Aug 2020
Depuis, un nombre important de données statiques et dynamiques sont régulièrement poussées non seulement par le Gouvernement lui-même mais également les autres institutions Calédoniennes : 15 partenaires jouent le jeu.
Réalisation précédente
L'année dernière a été développée une application mobile qui met en valeur les offres d'emplois, grâce au DataSet offres-demploi et qui compte un pool de 120 utilisateurs réguliers.
Il est toujours intéressant de fournir des services vivants qui mettent en valeur ces données, voire permettent de simplifier les démarches interinstitutionnelles ou tout simplement de favoriser la digitalisation des services.
Faciliter l'accès à la donnée
Le succès d'une API tiennent en deux caractéristiques principales :
- La disponibilité
- La qualité des données (juste, à jour, ...)
- Le design : simplicité d'intégration, documentation
J'ai donc eu envie d'appliquer cela au dataset entreprises-actives-au-ridet qui a récemment rejoint la plateforme :
data.gouv.nc@datagouvncLa liste des entreprises actives au RIDET est désormais disponible sur data.gouv.nc!
data.gouv.nc/explore/datase…04:22 AM - 22 Apr 2021
L'API fournie par défaut n'est pas si évidente bien que parfaitement documentée.
En tant que développeur, je suis davantage habitué à des endpoints dédiés et simples. J'ai eu envie de deux choses.
Un endpoint du type :
/ridet/0132720
Une documentation de type Swagger et de proposer mon API documentée via OpenAPI.
🚀Expérimentation
Je me suis donc lancé dans une expérimentation : développer un proxy REST qui consomme l'API Open Data dans le but de la rendre plus "sexy".
Je la livrerai en Open Source, via une image Docker publique afin de voir les retours et faire ma propre expérience sur ce jeu de données que je ne connaissais pas vraiment.
🎇A vous de jouer !🎇
Quoi de mieux, pour expérimenter, que de jouer avec un scénario interactif... en live ?
🕹️J'ai donc créé le scénario Get Ridets with Open Data.
Code source
❔ About
ridetapi-nc
is an API that wrapps an easy to use set of endpoints on top of
New Caledonia Open Data Dataset.
The aim of this API is to make things easier than ever to get that datas.
🕹️ Katacoda Playground
You can give a try to this API thanks to this dedicated KataCoda scenario.
Related stuff
- New Caledonia Open Data Dataset
- Open Data Soft documentation
- Online Isee.nc form
- ridetnc-api on DockerHub
Run API by yourself
Maven
mvn spring-boot:run
🐳 Docker
sudo docker run -d --name ridets-nc -p 8080:8080 rastadidi/ridetnc-api:latest
sudo docker ps
Usage
- Swagger : http://localhost:8080/
- Get a given ridet :
http://localhost:8080/ridet/0426049
- Search ridets :
http :8080/ridets q==sports page==1
Call examples
Get infos about the unique society that has ridet 0426049
:
http :8080/ridet/0426049
Check if a society does exist (will return "status": 404
)
http :8080/ridet/04260499
Get a list of societies and search with a…
💰Un autre jeu de données très prometteur💰
En Juillet 2021, data.gouv.nc a ouvert l'API publique des prix à la consommation affichés sur le site prix.nc, ainsi que la documentation Swagger :
data.gouv.nc@datagouvncOpen data et Lutte contre la vie chère ... Découvrez l'API publique des prix à la consommation affichés sur le site prix.nc !
data.gouv.nc/explore/datase…22:19 PM - 25 Jul 2021
Top comments (0)