OpenAPI Spec

[ioggstream]

I expect

The API to be defined via an OpenAPI 3 specification file.

[jgaffuri]

Excellent suggestion indeed !

[ioggstream]

I provided a draft file that you are welcome to integrate in the repo.

In this repo https://github.com/ioggstream/api-confini-amministrativi I made a similar work downloading data from www.istat.it, processsing the shapes and publishing on github pages both data and indexes, eg.

https://ioggstream.github.io/api-confini-amministrativi/2020-01-01/generalizzata/ripartizione/

A related OAS is this Gisco one I just stubbed https://gist.github.com/ioggstream/21649e67c07f794c8dfe886d324cd403