Posts Tagged: Design

4 Design Tweaks to Improve API Operations

We’ve previously discussed best practices when it comes to designing an API with quality developer experience. But what will the long term operational repercussions be for the design moves we make now?

For example, if URLs are designed without metadata to describe actions, later on, product owners will have a difficult time staring at unintelligible logs. Read more

Stop Polling and Consider Using REST Hooks

Web APIs have been around for a long time now. While that means there’s a lot of great tools from a lot of amazing developers, it also means that, as a community, the API space has held on to some practices for a long time — some would argue too long in many cases. Read more

Is GraphQL The End of REST Style APIs?

The world of APIs is one of innovation and constant iteration. The technologies that once drove the largest and best solutions across the web have been supplanted by new, more innovative solutions.

That is why it’s surprising, then, that many developers have clung to what they consider the bastions of web API development. Read more

Designing a True REST State Machine

There are many misconceptions surrounding what exactly Representational State Transfer (REST) is. The prime of which is the concept of hypermedia, or defined in full context, Hypermedia as the engine of application state (HATEOAS).

Jargon aside, hypermedia is actually a valuable idea that many self-touted “RESTful” web APIs do not adhere to. Read more

First API implementation planning whiteboard

First Time API Implementation for Entrepreneurs

Any business or organization in the world can bring an API to market, but APIs are increasingly synonymous with the startup world. Entrepreneurs are using APIs to deliver their products for a number of reasons:

  • They can provide a convenient, easily understood and accessible mechanism for getting an MVP in front of customers;
  • Having an API in the market can provide crucial insight into the value of your product through feedback from the developer community;
  • An API can be one of several channels for delivering your product or may be the product itself.
Read more