API response format and documentation.

We are looking at developing some automated systems using the remote API. Once issue we are immediately facing is the format of the responses.

The command line response is in a very odd text format that is pretty much useless. For instance list-domains crops the ends off long domains and provides no form of unique site ID that we can use to handle the responses. The HTTP API seems to do the same thing.

There also seems to be little or no documentation on the format of arguments that we pass to the commands. While --help will tell us what we need to send, in many cases we find ourselves in a painful process of trial and error trying to work out what to send. Is there any decent documentation or examples we can make use of?