Architecture

A collection of 11 posts
API Development with Design-first Approach

API Development with Design-first Approach

Today, the best practice when implementing APIs on a large scale is to start with an API design stage. This approach is called API design-first, sometimes also known as API-first, schema-first, or design-first. The design-first approach advocates for designing the API’s contract first before writing any code. This is »
Top 5 REST API Design Problems

Top 5 REST API Design Problems

Here at RestCase we are working with many companies and help them develop secure services and APIs. When working with developers on how to design and build quality APIs and microservices and I am seeing many common design problems that are not organization / company-specific. These problems are better to be »
6 Most Significant Changes in OAS 3.0

6 Most Significant Changes in OAS 3.0

The OpenAPI Spec, formerly known as Swagger has announced the release of Open API Specification 3.0. This is a very important milestone, but it is also the first major release since the specification was entered into the Linux Foundation. The OpenAPI Specification (OAS) is supported by various industry heavyweights »
7 Rules for REST API URI Design

7 Rules for REST API URI Design

Before going over the rules for REST API URI design, let’s do a quick overview on some of the terms we are going to talk about. URIs REST APIs use Uniform Resource Identifiers (URIs) to address resources. On today’s web, URI designs range from masterpieces that clearly communicate »
RESTful API Authentication Basics

RESTful API Authentication Basics

Almost every REST API must have some sort of authentication. One of the most common headers is call Authorization. Wait a minute, we are talking about authentication but why the Authorization header? Authentication vs. Authorization The distinction between authentication and authorization is important in understanding how RESTful APIs are working »
RESTful API Basic Guidelines

RESTful API Basic Guidelines

Your data model has started to stabilize and you're in a position to create a public API for your web app or your device. You realize it's hard to make significant changes to your API once it's released and want to get as much »
RESTFul API Versioning Insights

RESTFul API Versioning Insights

When it comes to API versioning there are so many best practices and insights but there is still not a rock solid best practice. In order to understand the Restful API versioning we first need to understand the problem. The Versioning Problem One shall not break your clients Changing your »