🏢 Open Data & Ridets en Nouvelle-Calédonie

adriens - Aug 8 '21 - - Dev Community

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

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 :

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
Enter fullscreen mode Exit fullscreen mode

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

Docker Pulls Docker Stars

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

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 :

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .