Related articles

APIcurio Walkthrough

We walkthrough using APIcurio, an API design editor supporting OpenAPI Spec.Having a thoroughly documented, machine-readable API is considered top of the development. However, creating a consistent format for the API and documentation is challenging with no outside guidance or structure. In an effort to provide this structure for API creators, the OpenAPI Specification was…

Read More

Tooling Review: Swagger Inspector

Testing is often considered to be a secondary consideration at the end of the development lifecycle. The common thought is that APIs are tested after they are built, and that any issues found should be addressed during these later stages. While this is certainly a method that can iver a finished product, utilizing testing in such…

Read More

Why You Should Be Designing APIs to Spec

There’s a good reason why building APIs can be extremely tough and time-consuming: they have to cater to both human and machine needs. Inherently, this is pretty difficult. Machines are picky and rely on pure logic; they crave rigid, hierarchical structures and definite instructions. On the other hand, humans prefer things to work on an…

Read More

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. That being said, there are some basic requirements that, despite…

Read More

What Should You Consider Before OpenAPI Adoption?

The OpenAPI Specification is adored, and its usefulness has seen it be subject to sweeping adoption in recent years. It’s clear that many see the value of the OpenAPI Specification, and see value in its adoption. As with any trend, there’s a certain amount of consideration that should be paid before adopting the solution carte…

Read More

Review of APIStrat in Portland

Summary of API Strategy & Practice conference held in Portland from Oct 31 – Nov 2.  Last week I was fortunate enough to attend, speak, and meet new API enthusiasts at APIStrat in Portland, Oregon. API Strategy & Practice is a series of quality API-themed conferences held throughout the United States, originally organized by API Evangelist…

Read More