While I enjoy a challenge I think it would really help developers if the API documentation was a little more comprehensive. I have spent many hours working out how to do things by searching for people's posts e.g.: Extras is not explained in the API but I found a post on here giving details. If I had not found it I would have assumed that a get for images did not return any URLs.
SO basically we need someone at SmugMug to Awsome-ize the Docs :)