Related articles

The Three Principles of Excellent API Design

We all know that using a well-designed API is extremely rewarding, while using a poorly-designed API can be frustrating enough for us to give up altogether. However, when we ourselves strive to build the best-designed APIs possible, we tend to trip up right away, wondering: what makes an API’s design good or bad? For Arnauld Lauret,…

Read More

What’s The Difference Between Versioning and Revisioning APIs?

Release management is an important part of any API development lifecycle. That being said, it is also consistently overloed, often considered as an afterthought than a foundational element of the API and business environment. This is unfortunate, as implementing proper release management can not only prevent significant issues from arising, it can also improve…

Read More

Understanding Idempotency and Safety in API Design

What does it mean in programming to be idempotent? Today, we’re going to lo at the concepts of idempotence and safety, and identify what makes them so very important in the context of web API design. We’ll compare idempotence and safety to see how they’re different, and discover why this division is important. We’ll learn…

Read More

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

Would An Experimental API Strategy Work For You?

API design is a complex topic — what works for some providers does not for others. It seems that with each year, new approaches are developed, and new thoughts on how APIs fit into the overall platform strategy emerge. We’re specifically seeing this occur in banking, as market trends force agile ways of bringing…

Read More

When to Use What: REST, GraphQL, Webhooks, & gRPC

With all of the and proclamations about REST, we can sometimes forget that it’s simply one of many options. REST is a very good standard for a wide variety of APIs, but there are other API design styles for nuanced scenarios. To help API developers make sense of which API design style to…

Read More