Posts Tagged: HTTP

The Easiest Way to Generate API Documentation

The Easiest Ways to Generate API Documentation

Whether you’re a startup developing your first API or an established player in the API economy, the truth is becoming steadily more apparent; providing quality API documentation is vital to the success of an API initiative. API documentation is an important part of the product offering, delivering affordances to the developer community to help them understand exactly what an API offers and how to use it. Read more

How to Wrap a REST API in GraphQL

How to Wrap a REST API in GraphQL

GraphQL is a powerful tool that we’ve discussed previously at Nordic APIs. As with any emergent tool in the API space, however, there’s some disagreement on exactly how to implement it, and what the best practices for its implementation and use case scenarios are. Read more

Asynchronous APIs in Choreographed Microservices

When building microservices you have to first make a decision: How am I going to manage service-to-service communication? Most developers will answer immediately: API calls. But then, more questions come to mind:

  • Am I going to call services directly?
  • Doesn’t it block the caller service?
Read more
Most common instances of unrestful APIs

The API that Defied REST: Most Common Instances of unRESTful APIs, and What Really Matters

RESTful design is akin to the graphical user interface on modern computers — ubiquitous enough to be considered the de facto choice, but in practice, not necessarily the only option. REST is certainly considered by many to be the king of the hill, but it’s wrong to think it’s the only player in town. Read more

Don’t Underutilize These 5 Amazing HTTP Performance Features

Don’t Underutilize These 5 Amazing HTTP Performance Features

So, you’ve published a web API? Well done! You’re serving it over HTTP(S), right? Most developers see no reason to distrust the protocol that’s been holding the web together for almost 30 years. HTTP is very performant, scalable and reliable – in fact, it has multiple nifty performance features to make sure developers can make the most out of the applications built upon it. Read more