User experience design for APIs
blog.keras.io/user-experience-design-for-apis.html
What Jamie wrote
Great topic that more thought should be going to. API design is largely an afterthought for many services. You can tell API's that are just a dump of internal objects. They are hard to use and equally hard to understand. This article shows a good start to doing this right.