openstack team mailing list archive

[Michael Mayo <mike@xxxxxxxxxxxxx>]

All this talk about auth and making the API easy for developers to use got me thinking.

The two most popular formats for APIs are XML and JSON.

XML is language neutral and sort of painful to read by a human.  And writing an XML parser sucks.  It's not hard, but it's time consuming and annoying.

JSON is easier to read and easier to parse, so it is becoming the most popular choice.  But the really cool feature of JSON is that if you're consuming the API in Javascript, you don't have to parse at all because JSON is the native object format for Javascript.

So... how about we offer more native formats for other languages?  For Java developers, offer raw binary that represents a Serializable when they call something like GET /servers.java.  Zero parsing for Java developers.

For Objective-C, GET /servers.cocoa returns XML in the NSPropertyList XML format.  Again, zero parsing.

If Python has object serialization you could do it too.  That would probably be the easiest to code.

What do you think?