Posts Tagged: dx

The Art and Personalization of The API Documentation Experience

An API is a method of communication. At best it’s a tool to make building software easy, but at worse a time-waster and constant hassle. Good APIs abstract complexity and quickly provide clear valuable data, whereas bad APIs abstract too much, don’t allow for any customization, or aren’t clear and therefore are difficult to use. Read more

4 APIs Doing Developer Experience Really Well

Developer experience is a vital component of API design. The best developer experience will result in a better, stronger, more useful API, and by extension, a better, stronger, more useful end user experience.

While developer experience is very much a subjective thing that is highly dependent on the developer consumer, there are nonetheless some recurring positive elements that successful APIs with good experience share. Read more

Using API Analytics to Empower the Platform

API metrics are perhaps the single most important factor in improving any API system. Metrics are inherently valuable – tracking data on API usage, availability, uptime, and other insights is pivotal to keeping a consistently healthy platform. That being said, it’s an unfortunate truth that many developers do not leverage API analytics to their full power, simply preferring to consider metrics a business tool, and little else. Read more

5 Frequent Developer Community Mistakes (And How To Fix Them)

We’ve been in the API game for a little while now, and we’ve seen our fair share of compelling developer communities being cultivated. On the flipside, we’ve also seen some epic fails. At our 2016 Platform Summit, Shayne Parmelee, developer experience lead at Shopify, talked about some of his own successes (and failures) during his time with the company. Read more

How to Optimize the API Response Package

If there’s anything that has the most “bang for the buck” in the IT world, it’s optimization. Optimization, or the process of simplifying, offloading, or otherwise reducing the processing demand of an entity, can have significant benefits to almost any system, and when done properly, can take even the most monolithic system into the realm of high efficiency and extreme usability. Read more