Posts Categorized: blog

The Benefits of Using JSON API

In the world of API craft, no area is more hotly discussed than design. From REST, gRPC, to GraphQL, there are many approaches to designing and standardizing web API interactions. Today we turn our focus to another approach, JSON API, a specification for building APIs detailed at JSONAPI.org. Read more

What is a JWT?

Why Can’t I Just Send JWTs Without OAuth?

A JSON Web Token or JWT is an extremely powerful standard. It’s a signed JSON object; a compact token format often exchanged in HTTP headers to encrypt web communications.

Because of its power, JWTs can be found driving some of the largest modern API implementations. 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 and now adopted as a Linux Foundation event. Read more

Introduction to API Versioning Best Practices

Change is inevitable and growth is a good thing. When your API has reached the point of expanding beyond it’s original intent and capacity, it’s time to consider the next version.

Whether that next iteration is a whole number version bump or just a feature expansion, it’s important to consider the pros and cons of how you let your developers know about it. Read more

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