dhis2-devs team mailing list archive

[Morten Olav Hansen <mortenoh@xxxxxxxxx>]

On Sun, Aug 17, 2014 at 2:04 AM, Mahendra Kariya <
mahendra.kariya@xxxxxxxxxxxxxxxx> wrote:

> We have another quick question. By when can we expect the API to be
> completely stable?
>

I think what you see in 2.16 is more or less stable, we will continue
fixing the backend and adding features, but we now hope we have something
that we don't need to change.

Of course, there is still some issues with the data format, you can't just
import data from /api/type/ID and PUT it back into /api/type/ID, this is
because the output is using our new system, and the input is still using
Jackson, its 99% there, but there a few minor issues.. I hope to have this
fixed in 2.17, so that we can do proper import/export from all endpoints
(but will probably still use Jackson for import, since we are not ready to
replace that yet).

As for properties etc, those can still change I guess, but I'm hoping that
we can more or less rely on what we have now, from time to time we will see
bugs (like the recect renaming of programTrackedEntityAttribute.attribute
=> programTrackedEntityAttribute.trackedEntityAttribute) that will be fixed.

We are also talking about adding versioning to our API, since I'm sure at
some point in the future we DO want to change/delete or update parts of our
data model, so we need something to help with that (so that we don't break
all our 3rd party apps/clients). I'm sure we can also do a better job at
announcing changes to the data model on the dev list, so at least people
will know that things changed (the big problem here is if you want to
support multiple DHIS versions with one app).

--
Morten