Create a Swagger site for the REST API
The API is difficult enough to navigate without the ability to quickly test an API call against a URI. Your client api is ridiculously confusing but a swagger endpoint would at least allow us to hit the links for a given resource object directly to see if we are fishing in the correct pond. The current situation is prohibitively painful.
Great news! Swagger has been introduced as part of the 3.17 release. See our blog post for more info.