I’m finding the resource representation included for the various API calls very useful as with some modifications they can be used to automatically generate classes that allow for easy deserialization of API results. However, this can become problematic when the contents of the response change as they have a couple of times since I’ve been using the beta.
Going forward is there any chance that changes to these resources will be documented? Especially when the service is out of beta.
For the record (and in case it is of use for anyone else) I’ve been using http://jsonutils.com/ to create classes based on the resource representation. The only issue is that it thinks everything is a string because it thinks it’s creating based on data rather than a representation of that data and all interperates all the variable types enclosed in quotes are actually strings.
A quick fix for this is to search and replace “integer” with 0 and “boolean” with true. Dates I’ve had to change by hand.