OSDir


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Default API response type: XML -> JSON


The time would be better spent on fixing the docs.

It is time to turn Cloudstack into a production quality product with documentation that actually reflects the quality of the design and functionality.

At the moment you have 2 people willing to work on the docs waiting for a committer to decide that professional documentation matters.

This proposal seems to make the product more complicated with no substantial benefit. Parsing XML is a well-known technology and switching to JSON does not seem to reduce the code required or reduce the complexity of the code.

If there is a desire to me "more modern", fix the documentation.


On 24/04/2018 6:14 AM, Marc-Aurèle Brothier wrote:
@rafael - I think it's overkill to have this as a configuration option. We
should have one default response type, or maybe not have a default one and
enforce the use of the response type the client is willing to receive.

On Mon, Apr 23, 2018 at 3:39 PM, Rafael Weingärtner <
rafaelweingartner@xxxxxxxxx> wrote:

I do think it is an interesting proposal. I have been thinking, and what if
we do something different; what about a global parameter where the root
admin can define the default serialization mechanism (XML, JSON, RDF,
others...)? The default value could be XML to maintain backward
compatibility. Then, it is up to the root admin to define this behavior.


On Mon, Apr 23, 2018 at 10:34 AM, Marc-Aurèle Brothier <marco@xxxxxxxxxxx>
wrote:

Hi everyone,

I thought it would be good to move from XML to JSON by default in the
response of the API if no response type is sent to the server along with
the request. I'm wondering that's the opinion of people on the mailing
list.

Moreover, if anyone knows a tool working with the API in XML can you list
them, so I could check the code and see if the change can be done without
breaking it.

PR to change default response type: (
https://github.com/apache/cloudstack/pull/2593).
If this change would cause more trouble, or is not needed in your
opinion,
I don't mind to close the PR.

Kind regards,
Marc-Aurèle



--
Rafael Weingärtner


--
Ron Wheeler
President
Artifact Software Inc
email: rwheeler@xxxxxxxxxxxxxxxxxxxxx
skype: ronaldmwheeler
phone: 866-970-2435, ext 102