In my experience, a solid REST API denotes success/failure via HTTP status code, and the response contains a represnetation of the created/modified object's new state. The Zuora REST API's various endpoints return inconsistent data structures, none of which directly rerpesent the object which was acted upon. Specifically, I'd love to see the CRUD endpoints denote creation/update success via an HTTP status code in the 200 range, remove the `success` property of the response body, and return all current properties of the newly created/updated object. As is, I have to POST data for object creation, then use the ID that was returned to GET an actual representation of the created object. This is, as I said, rather non-standard and a waste of API calls and processing time.
... View more