It would be great if the API had a way of returning a JSON object that defined field length and type and version number for objects. Then code could be written against it to update models and databases and detect changes.
Right now, you have to login to a shop and inspect fields to figure out what type and how long they are.