← Back to team overview

dhis2-devs team mailing list archive

Re: Support for comma delimited identifiers in the API?

 

Hi Jason,

thanks for the suggestion. No doubt there is a need for a compact format
for items.

Only problem is that the "," character is defined as "reserved" in the URL
"spec":

http://www.ietf.org/rfc/rfc1738.txt p2.2

and causes e.g. spring mvc to split the value into multiple query params.

For analytics we use ";" for delimiting, which is also reserved, but is at
least not causing trouble with spring mvc.

Would ";" be okay? If so please write a blueprint.

Lars






On Wed, Dec 11, 2013 at 5:49 AM, Jason Pickering <
jason.p.pickering@xxxxxxxxx> wrote:

> Hi there.
>
>  I have been working with another REST API recently and one of the
> features is the support for comma delimited lists as part of a API request.
> From this example from the docs..
>
> curl "http://apps.dhis2.org/dev/api/completeDataSetRegistrations?dataSet=pBOMPrpg1QX&dataSet=BfMAe6Itzgt&startDate=2013-01-01&endDate=2013-01-31&orgUnit=YuQRtpLP10I&orgUnit=vWbkYPRmKyS&children=true"; -H "Accept:application/xml" -u admin:district -v
>
>
> It would be useful to support this request as well..
>
> curl "http://apps.dhis2.org/dev/api/completeDataSetRegistrations?dataSet=pBOMPrpg1QX&dataSet=BfMAe6Itzgt&startDate=2013-01-01&endDate=2013-01-31&orgUnit=YuQRtpLP10I,vWbkYPRmKyS&children=true"; -H "Accept:application/xml" -u admin:district -v
>
> In some cases, we have many dozens or hundreds of orgunit UIDs in the
> requests, and it might be just a bit simpler to have these delimited.
>
> Thoughts?
>
> Regards,
> Jason
>
>
>
>
>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~dhis2-devs
> Post to     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~dhis2-devs
> More help   : https://help.launchpad.net/ListHelp
>
>

Follow ups

References