At the moment, there are a lot of changes in our REST API between the DATAGERRY releases. Mostly, the JSON structures, that needs to be sent are affected
the field “root” in categories were gone with database update 20200226
date fields in objects needs to be set in a new format since database update 20200214
If a user sends a JSON structure in an incorrect format, parts of DATAGERRY will break. Also there is no documentation for REST endpoints and expected JSON structures.
For the future, we’ll need a concept for a more stable REST API. This concept should be the base for migrating the current REST API step by step (endpoint by endpoint) within the next few sprints.
In this concept, we should clarify the following things:
how can we achieve a more stable REST API (REST versioning, internal API for us, external API for users, …?)
how can we document our REST API
what are the next steps for implementation
how can we validate input JSON structures
This concept should also be documented in our development guide.
Changed the Jira Workflow from DATAGERRY -> DATAGERRY 2.0