It would be really helpful if you guys would document the return values from your API. Your documentation is pretty clear on the request URL and POST parameters, but no where does it give examples for or document what you will receive from the API call.
I'm currently working on some contribution to Mousetrap and it's difficult to know if the fields I get back will always be there. For instance, if an optional field is empty (null) will it return as "" in the API call or will the attribute not exist at all?
Something like this would be nice... http://developer.37signals.com/basecamp/companies.shtml
-Ryan
#1 Posted by Marc Guyer Support staff on 25 Jun, 2010 02:35 PM
Agreed -- this has been on the wishlist for a while. However, there's nothing more to document than what can be seen within your own account. If you're looking at a customer in the GUI, you can simply replace the /admin/ with /xml/ and you'll get the single customer response XML for that customer. This is the response for each customers/whatever API call. We would have a hard time doing justice to all of the different possibilities for responses when you consider all of the pricing plan config differences and customer data options.
That said, we do have plans to add some rudimentary response examples to the docs.
Marc Guyer closed this discussion on 25 Jun, 2010 02:35 PM.