search

riigikogu-kantselei / api

Public issue tracker for Open data API at the Chancellery of the Riigikogu
https://api.riigikogu.ee/
GNU General Public License v3.0
10 stars 0 forks source link

JSON data format standardisation #1

Open ottomattas opened 7 years ago

ottomattas commented 7 years ago

As proposed before, we are considering different specifications and approaches to the dataset available. At the moment, we are looking at:

ottomattas commented 7 years ago

Initial discussion in okestonia/opendata-issue-tracker#60

ttalviste commented 5 years ago

At the moment, it is not possible to use tools like:

For example on blocker is:

The problem lies in the generated specification https://api.riigikogu.ee/v2/api-docs Model definitions contain special letter, spaces, braces and other special characters. For example, PagedResources are a known issue in the Codegen tool, which is out of the scope, but if the model definitions are updated, it is possible to generate the UML for better understanding.

All above hinder the machine readability of the API which is one of the 8 criterias set for Open Data.