Old API documentation

HaydnJ · 29 March 2023 11:36

Is there an archive link for the old API documentation, v2.33 specifically?

I have a very old 2.33 instance (upgrade is coming soon, I hope!!!) and I need to perform some bulk operations on user groups and sharing.

As I found out to my horror a few days back, sharing and collection apis don’t work quite the same way as they do now, and to avoid me making a huge mess of things and needing to restore a national HMIS, I would really like to see the documentation and make sure everything I am about to do is going to work.

Edit: I think I should go into more detail.

This DHIS2 instance has managed to collect a number of duplicate user groups (same name and nearly identical lists of user members). I have collated these duplicates and for each one identified the original user group and created a master list of all the users from both duplicates.

My intention is to use the User Group admin page to delete the duplicate group, but then use the API to update the users in the original group to contain both sets of users. There are quite a large number of these so it is impractical to do it manually. Updating collections via the API is an area I am a little wobbly on, especially on older versions.

Rene · 29 March 2023 14:02

Hi!

Our docs are open source! And it looks like there’s a branch for each version.

This is probably the file you’re looking for:

github.com

dhis2/dhis2-docs/blob/2.33/src/commonmark/en/content/developer/web-api.md

# Web API

<!--DHIS2-SECTION-ID:webapi-->

The Web API is a component which makes it possible for external systems
to access and manipulate data stored in an instance of DHIS2. More
precisely, it provides a programmatic interface to a wide range of
exposed data and service methods for applications such as third-party
software clients, web portals and internal DHIS2 modules.

## Introduction

<!--DHIS2-SECTION-ID:webapi_introduction-->

The Web API adheres to many of the principles behind the REST
architectural style. To mention some few and important ones:

1.  The fundamental building blocks are referred to as *resources*. A
    resource can be anything exposed to the Web, from a document to a
    business process - anything a client might want to interact with.

This file has been truncated. show original

HaydnJ · 29 March 2023 14:12

Thanks @Rene,

I will save this repo for next time!