Learn what is rest API in 10 minutes

Learn what is rest API in 10 minutes
Learn what is rest API in 10 minutes

REST stands for “Representational State Transfer” which is an incredibly convoluted term for something that is really simple.

When you load an everyday website like Quora, your browser is causing requests to Quora’s internet servers, that look one thing like this:

All which means is that the browser desires to induce (i.e. download) a file known as “/pages/index.html”. the online server in response, delivers the HTML knowledge. A typical information processing system like Quora can create dozens of requests like this for CSS, JavaScript files, images, that kind of issue.

REST essentially is the same issue, however, the remainder APIs tend to deliver knowledge that is beneficial to computers, instead of knowledge that is beneficial to humans. thus instead of using GET to transfer HTML files, images etc. REST APIs tend to deliver JSON or XML knowledge. JSON or XML isn’t that helpful to humans, it’s a pain to browse, however to a laptop, it’s terribly straightforward to interpret.

So a REST API appearance additional like this:

And that can respond with one thing like this:

Graphical user interface, application

Description automatically generated

That knowledge isn’t terribly nice to appear at for the typical user, however it’s exactly what i want to create a currency conversion app.

REST isn’t doing something that communications protocol didn’t already give, however is an additional method of exploitation communications protocol to create info sources that are suited to developers creating applications instead of truly being read by an associate user.

There are different communications protocol commands further as GET, like PUT, DELETE and a few different ones, place essentially suggests that “upload” and that  in all probability don’t have to be compelled to tell you what DELETE suggests.

Apparently, REST was outlined in 2000, however, several folks were exploiting communications protocol during this manner before then. very REST simply place a reputation to what several folks were already doing:

Using communications protocol to provide data rather than sites.

RESTful applications use communications protocol requests to perform four operations termed as CRUD (C: produce, R: read, U: update, and D: delete). produce and/or update is employed to post knowledge, get for reading/listing knowledge, and delete to get rid of knowledge.

RESTful consists of strategies such as; base URL, URL, media sorts, etc.

Understanding REST API Design

A picture containing computer

Description automatically generated

There are six key constraints to REST API style which should be kept in mind of once deciding whether or not this is often the right API type for your project.

The consumer-server constraint works on the construct that the client and also the server ought to be broken away from one another and allowed to evolve severally and severally. In different words, I ought to be able to create changes to my mobile application while not impacting either the info structure or the information style on the server.

At identical times, I ought to be able to modify the information or create changes to my server application while not impacting the mobile consumer. This creates a separation of issues, lease every application grows and scales severally of the opposite and permits your organisation to grow quickly and expeditiously.


The fundamental explanation is:

By stateless it means that the server does not store any state regarding the client session on the server aspect. The consumer session is keep on the client. The server is stateless implies that each server will service any consumer at any time, there’s no session affinity or sticky sessions. The relevant session info is keep on the consumer and passed to the server as required.

That doesn’t preclude different services that the online server talks to from maintaining state regarding business objects like looking carts, simply not regarding the client’s current application/session state. The client’s application state ought to ne’er be keep on the server, however passed around from the client to each place that desires it.

That is wherever the ST in REST comes from, State Transfer. You transfer the state around rather than having the server store it. this is often the sole thanks to scale to countless coinciding users. If for no different reason than as a result of countless sessions is countless sessions.

The load of session management is amortized across all the shoppers, the shoppers store their session state and also the servers will service several orders of magnitude or additional shoppers in a very homeless fashion.

Even for a service that you just assume will only need within the 10’s of thousands of coinciding users, you continue to ought to create your service homeless. Tens of thousands continues to be tens of thousands and there’ll be time and area value related to it.

Stateless is, however, the communications protocol and also the internet generally was designed to work associated is an overall less complicated implementation and you have got one code path rather than a bunch of server-aspect logic to keep up a bunch of session state.


Description automatically generated

A stateless API can increase request overhead by handling giant many incoming and outgoing calls, a REST API must be designed so that the storage of cacheable knowledge. This implies that once knowledge is cacheable, the response ought to indicate that the info will be kept up to a definite time (expires-at), or in cases wherever knowledge must be time period, that the response mustn’t be cached by the consumer.

By sanctioning this vital constraint, you’ll not solely greatly cut back the number of interactions together with your API, reducing internal server usage, however conjointly give your API users with the tools necessary to produce the quickest and best apps attainable. detain mind that caching is completed on the consumer aspect.

Whereas you will be able to cache some knowledge among your design to perform overall performance, the intent is to instruct the consumer on however it ought to proceed and whether or not or not the consumer will store the info quickly.

Uniform Interface
The key to the decoupling consumer from the server has a standardised interface that permits freelance evolution of the applying while not having the application’s services, models, or actions tightly coupled to the API layer itself. The uniform interface lets the consumer consult with the server in a very single language, free of the subject area backend of either. This interface ought to give associate unchanging, standardized suggestions that act between the consumer and also the server, like exploitation communications protocol with URI resources, CRUD (Create, Read, Update, Delete), and JSON.

Layered System
As the name implies, a layered system may be a system composed of layers, with every layer having selected practicality and responsibility. If we predict a Model read Controller framework, every layer has its own responsibilities, with the models comprising.

However, the info ought to be shaped, the controller that specialise in the incoming actions and also the read that specialise in the output. Every layer is separate however conjointly interacts with the opposite. In REST API style, the identical principle holds true, with totally different layers of the design operating along to produce a hierarchy that helps create an additional climbable and standard application.


Description automatically generated

A layered system also lets you conjointly permit you to encapsulate gift systems and move less normally accessed practicality to a shared intercessor whereas conjointly shielding additional trendy and normally used parts from them. in addition, the stratified system gives you the liberty to manoeuvre systems in and out of your design as technologies and services evolve, increasing flexibility and longevity as long as you retain the various modules as loosely coupled as attainable. 

There are substantial security benefits of having a stratified system since it permits you to prevent attacks at the proxy layer, or among different layers, preventing them from planning to your actual server design. By utilising a stratified system with a proxy, or making one purpose of access, you’re able to keep vital and additional vulnerable aspects of your design behind a firewall, preventing direct interaction with them by the consumer. 

Detain mind that security isn’t supported by a single “stop all” resolution, however rather on having multiple layers with the understanding that bound security checks could fail or be bypassed. As such, the additional security you’re able to implement into your system, the additional possible you’re to forestall damaging Attacks.

Code on Demand
The sixth and final constraint is that the solely optional constraint within the REST API. Code-On-Demand means a server will extend the practicality of a shopper on runtime, by causation code thereto that it ought to execute (like Java Applets, or JavaScript). I have not detected any quiet internet services that really send code from the server to the shopper (after deployment) and get it dead on the shopper, however, might be a robust thanks to improving the shopper.

A really nice feature of the simplicity that’s implemented by these six constraints (especially, uniform interface and homeless interactions) is that the shopper code becomes very easy to jot down. Most modern internet frameworks will decide what to try and do if we have a tendency to follow the conventions higher than and that they will beware of most of the boilerplate code for North American nations.

For example, within the new Oracle JET toolkit, we have a tendency to merely want the JavaScript below to make a client (and it might be even as simple in AngularJS):

Graphical user interface, text, application

Description automatically generated

A resource in REST could be a similar Object in Object headed Programming or is like associate degree Entity in a very information. Once a resource is known than its illustration is to be determined employing a commonplace format in order that the server will send the resource within the higher than aforesaid format and shopper will perceive an equivalent format.

The key abstraction of data in REST is a resource. Any information will be a resource: a document or image, a temporal service and so on. REST uses a resource identifier to establish the actual resource concerned in associate interaction between parts. The state of the resource at any explicit timestamp is thought as resource illustration.

Resource Methods
Another necessary issue related to REST is resource methods to be wont to perform the required transition. an oversized range of individuals incorrectly relates resource strategies to HTTP GET/PUT/POST/DELETE methods.

Roy Fielding has ne’er mentioned any recommendation around that methodology to be utilised in that condition. All he emphasizes is that it ought to be a uniform interface. If you opt communications protocol POST are going to be used to change a resource – instead of the general public suggesting communications protocol place – it’s alright and application interfaces are going to be relaxing.

Ideally, everything that’s required to alter the resource state shall be a part of API response for that resource – as well as strategies and in what state they’ll leave the illustration. A REST API ought to be entered with no previous information on the far side the initial URI (bookmark) and set of standardised media sorts that are applicable for the meant audience (i.e., expected to be understood by any consumer that may use the API).

From that time on, all application state transitions should be driven by consumer choice of server-provided selections that are given within the received representations or inexplicit by the user’s manipulation of these representations. The transition is also determined (or restricted by) the client’s information of media sorts and resource communication mechanisms, each of which can be improved on-the-fly (e.g., code-on-demand).

[Failure here implies that out-of-band info is driving interaction rather than machine-readable text.] Another issue which can assist you whereas building relaxing APIs is that query primarily based API results ought to be delineated by an inventory of links with outline info, not by arrays of original resource representations as a result of the question isn’t a substitute for identification of resources.

To explore more articles, click here.

By Yogesh Kumar