API shifted from HTML to XML?

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources

Is this intentional?

···


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it

···

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars

···

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

A shortcut to making an app would be if we exposed .json by default instead of XML:

https://apps.dhis2.org/dev/api/resources.json has nicely clickable links if the user has something like JSONView installed:

https://chrome.google.com/webstore/detail/jsonview/chklaanhfefbnpoihckbnefhakgolnmc

Knut

···

On Sun, Jul 13, 2014 at 8:18 PM, Lars Helge Øverland larshelge@gmail.com wrote:

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

We do expose JSON as the default, if you send header “Accept: /” that would return a JSON result. Problem is that the browser is usually sending something like “Accept: text/html, application/xml, …” so since it has no match for text/html, it will go to application/xml.

We are hoping to provide an API browser app for 2.17.

···


Morten

On Mon, Jul 14, 2014 at 7:25 AM, Knut Staring knutst@gmail.com wrote:

A shortcut to making an app would be if we exposed .json by default instead of XML:

https://apps.dhis2.org/dev/api/resources.json has nicely clickable links if the user has something like JSONView installed:

https://chrome.google.com/webstore/detail/jsonview/chklaanhfefbnpoihckbnefhakgolnmc

Knut


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 8:18 PM, Lars Helge Øverland larshelge@gmail.com wrote:

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

So you can’t just add .json to these links?

···

On Mon, Jul 14, 2014 at 6:04 AM, Morten Olav Hansen mortenoh@gmail.com wrote:

We do expose JSON as the default, if you send header “Accept: /” that would return a JSON result. Problem is that the browser is usually sending something like “Accept: text/html, application/xml, …” so since it has no match for text/html, it will go to application/xml.

We are hoping to provide an API browser app for 2.17.


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org


Morten

On Mon, Jul 14, 2014 at 7:25 AM, Knut Staring knutst@gmail.com wrote:

A shortcut to making an app would be if we exposed .json by default instead of XML:

https://apps.dhis2.org/dev/api/resources.json has nicely clickable links if the user has something like JSONView installed:

https://chrome.google.com/webstore/detail/jsonview/chklaanhfefbnpoihckbnefhakgolnmc

Knut


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 8:18 PM, Lars Helge Øverland larshelge@gmail.com wrote:

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Of course we could do that, but that would take away part of the restfulness of the API. I don’t think we should change the way our links works, just because a plugin supports making http://* into real links. I understand that it is a bit harder to browse the API right now, but that should be fixed soon. We don’t have to wait for 2.17 to be released for this, it could easily live as an external app, it shouldn’t take long to develop something like that.

···


Morten

On Mon, Jul 14, 2014 at 11:06 AM, Knut Staring knutst@gmail.com wrote:

So you can’t just add .json to these links?

On Mon, Jul 14, 2014 at 6:04 AM, Morten Olav Hansen mortenoh@gmail.com wrote:

We do expose JSON as the default, if you send header “Accept: /” that would return a JSON result. Problem is that the browser is usually sending something like “Accept: text/html, application/xml, …” so since it has no match for text/html, it will go to application/xml.

We are hoping to provide an API browser app for 2.17.


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org


Morten

On Mon, Jul 14, 2014 at 7:25 AM, Knut Staring knutst@gmail.com wrote:

A shortcut to making an app would be if we exposed .json by default instead of XML:

https://apps.dhis2.org/dev/api/resources.json has nicely clickable links if the user has something like JSONView installed:

https://chrome.google.com/webstore/detail/jsonview/chklaanhfefbnpoihckbnefhakgolnmc

Knut


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 8:18 PM, Lars Helge Øverland larshelge@gmail.com wrote:

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Much though I have to love json, this does seem to be a case where maintaining an xml stylesheet is the cleanest separation of form and content.

What about adding an xml processing instruction to the xml like:

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="<some base url>/dxf2html.xsl"?>
<document>
  ... </document>

This will have no effect on consuming the xml normally (except for making it one line longer) but will allow a browser to render it nicely.

Of course dxf2html.xsl would have to be maintained. It could be provided by an app. Or the whole url could be just a system setting. Then if the setting exists the processing instruction is emitted, if not then its not. Or there is a basic functionality which can be overridden by an app …

···

On 14 July 2014 05:19, Morten Olav Hansen mortenoh@gmail.com wrote:

Of course we could do that, but that would take away part of the restfulness of the API. I don’t think we should change the way our links works, just because a plugin supports making http://* into real links. I understand that it is a bit harder to browse the API right now, but that should be fixed soon. We don’t have to wait for 2.17 to be released for this, it could easily live as an external app, it shouldn’t take long to develop something like that.


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp


Morten

On Mon, Jul 14, 2014 at 11:06 AM, Knut Staring knutst@gmail.com wrote:

So you can’t just add .json to these links?

On Mon, Jul 14, 2014 at 6:04 AM, Morten Olav Hansen mortenoh@gmail.com wrote:

We do expose JSON as the default, if you send header “Accept: /” that would return a JSON result. Problem is that the browser is usually sending something like “Accept: text/html, application/xml, …” so since it has no match for text/html, it will go to application/xml.

We are hoping to provide an API browser app for 2.17.


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org


Morten

On Mon, Jul 14, 2014 at 7:25 AM, Knut Staring knutst@gmail.com wrote:

A shortcut to making an app would be if we exposed .json by default instead of XML:

https://apps.dhis2.org/dev/api/resources.json has nicely clickable links if the user has something like JSONView installed:

https://chrome.google.com/webstore/detail/jsonview/chklaanhfefbnpoihckbnefhakgolnmc

Knut


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 8:18 PM, Lars Helge Øverland larshelge@gmail.com wrote:

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Hi Guys

I must say, seconding what Knut has pointed out, I’m a bit worried by this development especially from a rapid app development perspective. I for one, am totally reliant on the json Web-API resources and interact with them on a day-to-day basis. So if accessing web-api json resources is becoming increasingly harder, what’s the alternative for app developers? I’m sorry guys for being ridiculous, but please help me out?

Regards

Farai

···

On Mon, Jul 14, 2014 at 10:36 AM, Bob Jolliffe bobjolliffe@gmail.com wrote:

Much though I have to love json, this does seem to be a case where maintaining an xml stylesheet is the cleanest separation of form and content.

What about adding an xml processing instruction to the xml like:

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="<some base url>/dxf2html.xsl"?>
<document>
  ... </document>

This will have no effect on consuming the xml normally (except for making it one line longer) but will allow a browser to render it nicely.

Of course dxf2html.xsl would have to be maintained. It could be provided by an app. Or the whole url could be just a system setting. Then if the setting exists the processing instruction is emitted, if not then its not. Or there is a basic functionality which can be overridden by an app …


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp


Farai Mutero

On 14 July 2014 05:19, Morten Olav Hansen mortenoh@gmail.com wrote:

Of course we could do that, but that would take away part of the restfulness of the API. I don’t think we should change the way our links works, just because a plugin supports making http://* into real links. I understand that it is a bit harder to browse the API right now, but that should be fixed soon. We don’t have to wait for 2.17 to be released for this, it could easily live as an external app, it shouldn’t take long to develop something like that.


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp


Morten

On Mon, Jul 14, 2014 at 11:06 AM, Knut Staring knutst@gmail.com wrote:

So you can’t just add .json to these links?

On Mon, Jul 14, 2014 at 6:04 AM, Morten Olav Hansen mortenoh@gmail.com wrote:

We do expose JSON as the default, if you send header “Accept: /” that would return a JSON result. Problem is that the browser is usually sending something like “Accept: text/html, application/xml, …” so since it has no match for text/html, it will go to application/xml.

We are hoping to provide an API browser app for 2.17.


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org


Morten

On Mon, Jul 14, 2014 at 7:25 AM, Knut Staring knutst@gmail.com wrote:

A shortcut to making an app would be if we exposed .json by default instead of XML:

https://apps.dhis2.org/dev/api/resources.json has nicely clickable links if the user has something like JSONView installed:

https://chrome.google.com/webstore/detail/jsonview/chklaanhfefbnpoihckbnefhakgolnmc

Knut


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 8:18 PM, Lars Helge Øverland larshelge@gmail.com wrote:

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Accessing the API is just as simple as before, we never defaulted to a JSON browsable API before. What we did, is to remove the old (and outdated) HTML rendering. For app developer, there should be no difference (unless you were parsing the HTML, but I hope you didn’t). JSON is just as supported as before, using either an extension (.json) or using the accept header (application/json). For your app, there should be no difference.

For browsing, we will provide an app shortly after release.

···


Morten

On Tue, Jul 15, 2014 at 12:23 AM, Farai Mutero fmutero@gmail.com wrote:

Hi Guys

I must say, seconding what Knut has pointed out, I’m a bit worried by this development especially from a rapid app development perspective. I for one, am totally reliant on the json Web-API resources and interact with them on a day-to-day basis. So if accessing web-api json resources is becoming increasingly harder, what’s the alternative for app developers? I’m sorry guys for being ridiculous, but please help me out?

Regards

Farai


Mailing list: https://launchpad.net/~dhis2-devs

Post to : dhis2-devs@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-devs

More help : https://help.launchpad.net/ListHelp

On Mon, Jul 14, 2014 at 10:36 AM, Bob Jolliffe bobjolliffe@gmail.com wrote:

Much though I have to love json, this does seem to be a case where maintaining an xml stylesheet is the cleanest separation of form and content.

What about adding an xml processing instruction to the xml like:

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="<some base url>/dxf2html.xsl"?>
<document>
  ... </document>

This will have no effect on consuming the xml normally (except for making it one line longer) but will allow a browser to render it nicely.

Of course dxf2html.xsl would have to be maintained. It could be provided by an app. Or the whole url could be just a system setting. Then if the setting exists the processing instruction is emitted, if not then its not. Or there is a basic functionality which can be overridden by an app …


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

Farai Mutero

On 14 July 2014 05:19, Morten Olav Hansen mortenoh@gmail.com wrote:

Of course we could do that, but that would take away part of the restfulness of the API. I don’t think we should change the way our links works, just because a plugin supports making http://* into real links. I understand that it is a bit harder to browse the API right now, but that should be fixed soon. We don’t have to wait for 2.17 to be released for this, it could easily live as an external app, it shouldn’t take long to develop something like that.


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp


Morten

On Mon, Jul 14, 2014 at 11:06 AM, Knut Staring knutst@gmail.com wrote:

So you can’t just add .json to these links?

On Mon, Jul 14, 2014 at 6:04 AM, Morten Olav Hansen mortenoh@gmail.com wrote:

We do expose JSON as the default, if you send header “Accept: /” that would return a JSON result. Problem is that the browser is usually sending something like “Accept: text/html, application/xml, …” so since it has no match for text/html, it will go to application/xml.

We are hoping to provide an API browser app for 2.17.


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org


Morten

On Mon, Jul 14, 2014 at 7:25 AM, Knut Staring knutst@gmail.com wrote:

A shortcut to making an app would be if we exposed .json by default instead of XML:

https://apps.dhis2.org/dev/api/resources.json has nicely clickable links if the user has something like JSONView installed:

https://chrome.google.com/webstore/detail/jsonview/chklaanhfefbnpoihckbnefhakgolnmc

Knut


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 8:18 PM, Lars Helge Øverland larshelge@gmail.com wrote:

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Ok, great stuff. Thanks Morten!

···

On Mon, Jul 14, 2014 at 8:07 PM, Morten Olav Hansen mortenoh@gmail.com wrote:

Accessing the API is just as simple as before, we never defaulted to a JSON browsable API before. What we did, is to remove the old (and outdated) HTML rendering. For app developer, there should be no difference (unless you were parsing the HTML, but I hope you didn’t). JSON is just as supported as before, using either an extension (.json) or using the accept header (application/json). For your app, there should be no difference.

For browsing, we will provide an app shortly after release.


Farai Mutero


Morten

On Tue, Jul 15, 2014 at 12:23 AM, Farai Mutero fmutero@gmail.com wrote:

Hi Guys

I must say, seconding what Knut has pointed out, I’m a bit worried by this development especially from a rapid app development perspective. I for one, am totally reliant on the json Web-API resources and interact with them on a day-to-day basis. So if accessing web-api json resources is becoming increasingly harder, what’s the alternative for app developers? I’m sorry guys for being ridiculous, but please help me out?

Regards

Farai


Mailing list: https://launchpad.net/~dhis2-devs

Post to : dhis2-devs@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-devs

More help : https://help.launchpad.net/ListHelp

On Mon, Jul 14, 2014 at 10:36 AM, Bob Jolliffe bobjolliffe@gmail.com wrote:

Much though I have to love json, this does seem to be a case where maintaining an xml stylesheet is the cleanest separation of form and content.

What about adding an xml processing instruction to the xml like:

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="<some base url>/dxf2html.xsl"?>
<document>
  ... </document>

This will have no effect on consuming the xml normally (except for making it one line longer) but will allow a browser to render it nicely.

Of course dxf2html.xsl would have to be maintained. It could be provided by an app. Or the whole url could be just a system setting. Then if the setting exists the processing instruction is emitted, if not then its not. Or there is a basic functionality which can be overridden by an app …


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

Farai Mutero

On 14 July 2014 05:19, Morten Olav Hansen mortenoh@gmail.com wrote:

Of course we could do that, but that would take away part of the restfulness of the API. I don’t think we should change the way our links works, just because a plugin supports making http://* into real links. I understand that it is a bit harder to browse the API right now, but that should be fixed soon. We don’t have to wait for 2.17 to be released for this, it could easily live as an external app, it shouldn’t take long to develop something like that.


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp


Morten

On Mon, Jul 14, 2014 at 11:06 AM, Knut Staring knutst@gmail.com wrote:

So you can’t just add .json to these links?

On Mon, Jul 14, 2014 at 6:04 AM, Morten Olav Hansen mortenoh@gmail.com wrote:

We do expose JSON as the default, if you send header “Accept: /” that would return a JSON result. Problem is that the browser is usually sending something like “Accept: text/html, application/xml, …” so since it has no match for text/html, it will go to application/xml.

We are hoping to provide an API browser app for 2.17.


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org


Morten

On Mon, Jul 14, 2014 at 7:25 AM, Knut Staring knutst@gmail.com wrote:

A shortcut to making an app would be if we exposed .json by default instead of XML:

https://apps.dhis2.org/dev/api/resources.json has nicely clickable links if the user has something like JSONView installed:

https://chrome.google.com/webstore/detail/jsonview/chklaanhfefbnpoihckbnefhakgolnmc

Knut


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 8:18 PM, Lars Helge Øverland larshelge@gmail.com wrote:

Hi,

yes its intentional. The HTML templates were static and too much hassle to keep in synch with the model.

App idea: make an app that renders a nice, linked HTML-view for all resources based on the json resources.

Lars


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

On Sun, Jul 13, 2014 at 2:44 PM, Knut Staring knutst@gmail.com wrote:

Or is there just a missing style file:
This XML file does not appear to have any style information associated with it


Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Sun, Jul 13, 2014 at 2:42 PM, Knut Staring knutst@gmail.com wrote:

Hi,

When I browse the API in 2.16, I seem to get XM
https://apps.dhis2.org/dev/api/resources

instead of HTML, like it was in 2.15

https://apps.dhis2.org/demo/api/resources


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org

Is this intentional?


Knut Staring

Dept. of Informatics, University of Oslo

+4791880522

http://dhis2.org