How to make self-descriptive APIs

How To Make A Self-Descriptive Enterprise API

One of the hardest things to do as an API provider is to work within the enterprise environment. This is due, in large part, to the very nature of enterprise structures – often slow to adopt new technologies, fundamentally distrustful of external solutions, and far more insular than most modern corporations would like to admit. Read more

Share the knowledge

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

Share the knowledge
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

Share the knowledge

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

Share the knowledge

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

Share the knowledge