Posts Tagged: usability

7 Items No API Documentation Can Live Without

Web APIs are highly variable things – they can be custom-built, designed around a single purpose, all-encompassing, and almost everything in between. Shifting requirements dictate what the interface is comprised of. Due to this, it’s hard to find commonalities between APIs and their user-facing portals. Read more

How to Optimize Developer Experience for Your API

Programming can be tough, especially when you’re starting out with a new language or trying to interact with a new API. It’s as if there are an endless number of strange procedures and functions with names you’ve never heard before, and all warranting special syntax. 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

API-playground-sandboxes-virtualization

Virtualization, Sandboxes, and Playgrounds for a Wholesome API

An API is only as good as it is known. Getting an API into a developer’s hands, demonstrating the power of your solution, and providing an environment in which they can test and manipulate data in a controlled, monitored way is perhaps one of the most important unsung heroes of API publication. Read more

A Human’s Guide to Drafting API Platform Policy

There are some languages in the world that are tough to master and for your average application developer none more so than Legaleze, a language so inaccessible that only a learned few can speak it fluently. The diction and terminology is generally so difficult that most don’t even attempt to learn: When presented with an API’s terms of use or platform policy, most developers simply click ‘I accept’ and get on with coding. Read more