Mailing-List: contact cloudstack-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: cloudstack-dev@incubator.apache.org
Received-SPF: pass (athena.apache.org: domain of rohit.yadav@citrix.com
 designates 203.166.19.134 as permitted sender)
From: Rohit Yadav <rohit.yadav@citrix.com>
To: "cloudstack-dev@incubator.apache.org"
	<cloudstack-dev@incubator.apache.org>,
	"cloudstack-users@incubator.apache.org"
	<cloudstack-users@incubator.apache.org>
Date: Mon, 17 Dec 2012 11:54:26 +0530
Subject: API response change
Thread-Topic: API response change
Thread-Index: AQHN3B8pdRgZbckvHE6WgckqXGnsRA==
Message-ID: 
 <0BCCCE152323764BB7FD6AE6D7A1D9060102894ECFCD@BANPMAILBOX01.citrite.net>
Accept-Language: en-US
Content-Language: en-US
acceptlanguage: en-US
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0

I've modified api layer to return cloudstack-version (prev. cloud-stack-ver=
sion in xml) as part of the api cmd response for json type, to be consisten=
t with xml response which includes version number:
https://git-wip-us.apache.org/repos/asf?p=3Dincubator-cloudstack.git;a=3Dco=
mmit;h=3Df8a483fc5a47cb66ac4788fcd7d53da0c9d6ea2b

The "cloudstack-version" information in response can be used by a client, f=
or example an api discovery service which cloudmonkey can use to process/re=
quest/cache apis from cloudstack mgmt server based on the version and check=
sum of api information (api info would be a datastructure sent as json or x=
ml from api server that has apiname, docstring, args etc. all the info that=
 cloudmonkey pre-caches during build time).
The version info can be obtained using the listCapability api, share your c=
oncern if there is some better way to do this or if we should revert this.

Lastly, if you look at the code, string builders are used to build xml and =
json responses (primitive c like coding), any suggestions if we can use any=
 APL compliant xml and json libraries to build them?

Regards.=