Agile RESTful API Design

There are two common workflows followed by software engineers developing RESTful API's: the Specification-first approach; and the Implementation-first approach. The Specification-first approach The OpenAPI specification (formerly known as the Swagger specification) is the most popular and widely adopted specification for RESTful APIs. And, there are a great many tools, libraries…

Read More

Swagger, Express and Content Negotiation

In a previous post, I wrote about creating the API for the The Vardyger publishing platform. In this post, we'll enhance the API by adding support for content negotiation (e.g., application/json or text/html). The Swagger Specification We'll start by updating the GET /posts/{id} URI, jump to…

Read More