This content is part of the Essential Guide: The API lifecycle: A look at planning to production


Contributor(s): Ed Hannan and Sarah Wilson

A RESTful API is an application program interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data.

A RESTful API -- also referred to as a RESTful web service -- is based on representational state transfer (REST) technology, an architectural style and approach to communications often used in web services development.

REST technology is generally preferred to the more robust Simple Object Access Protocol (SOAP) technology because REST leverages less bandwidth, making it more suitable for internet usage. An API for a website is code that allows two software programs to communicate with each another . The API spells out the proper way for a developer to write a program requesting services from an operating system or other application.

This video by Kevin Babcock
details RESTful API design and
related HTTP concepts.

The REST used by browsers can be thought of as the language of the internet. With cloud use on the rise, APIs are emerging to expose web services. REST is a logical choice for building APIs that allow users to connect and interact with cloud services. RESTful APIs are used by such sites as Amazon, Google, LinkedIn and Twitter.

How RESTful APIs work

A RESTful API breaks down a transaction to create a series of small modules. Each module addresses a particular underlying part of the transaction. This modularity provides developers with a lot of flexibility, but it can be challenging for developers to design from scratch. Currently, the models provided by Amazon Simple Storage Service, Cloud Data Management Interface and OpenStack Swift are the most popular.

A RESTful API explicitly takes advantage of HTTP methodologies defined by the RFC 2616 protocol. They use GET to retrieve a resource; PUT to change the state of or update a resource, which can be an object, file or block; POST to create that resource ; and DELETE to remove it.

With REST, networked components are a resource you request access to -- a black box whose implementation details are unclear. The presumption is that all calls are stateless; nothing can be retained by the RESTful service between executions.

Because the calls are stateless, REST is useful in cloud applications. Stateless components can be freely redeployed if something fails, and they can scale to accommodate load changes. This is because any request can be directed to any instance of a component; there can be nothing saved that has to be remembered by the next transaction. That makes REST preferred for web use, but the RESTful model is also helpful in cloud services because binding to a service through an API is a matter of controlling how the URL is decoded. Cloud computing and microservices are almost certain to make RESTful API design the rule in the future.

This was last updated in March 2019

Continue Reading About RESTful API

Join the conversation


Send me notifications when other members comment.

Please create a username to comment.

What will future RESTful API models look like and how will they differ from current designs?
No one know the future. I wonder why people keep asking about the future and how will be the future of that or that? Did anyone traveler to the future and saw how will be?
People ask about the future because they want to make decisions about what tools to use and what architecture to build, and deciding which will require the least amount of changes in the future. If you're building a house, would you build the foundation before deciding what size the house would be and how it would be used? This is a good question, and pfffff your answer shows you don't have a lot of experience with large application development. Web services has already changed significantly since it was first defined, and it will continue to do so.
Love it!
Every company in the world needs an API in the close future. There will be no way out in order to get connected.

What is REST API in layman's terms? Why REST API preferable for the IoT implementation?
"REST technology is generally preferred to the more robust Simple Object Access Protocol (SOAP) technology because REST leverages less bandwidth"

It is highly debatable that SOAP is more robust than REST. Because SOAP is much more complicated it is more likely to be brittle and break.

The advantages of REST are much more than just "less bandwidth" which is just a technical non-functional aspect. REST just uses a few simple operators to provide all the functionality you need and this common way of working is understood across the web. Whereas, SOAP needs particular interfaces for each application and a lot of work to achieve anything.

REST also means systems are loosely coupled, whereas SOAP results in systems that are tightly coupled.

Thus the advantages of REST are also functional and logical.
Wrong information. This article does not explain what is Restful API.
Can we get data in my Android app through the API?
Thank you for the article.

I am wondering whether you could please point me in the right direction about our issue with REST API?

We used to use a plugin called <a href="">REST API</a> that helped our Wordpress posts feed into an app.

But the plugin had to be deactivated because it stopped the new post editor in Wordpress 5.0.1 from working (would not Publish/Save, Featured image preview and Category and Tags tabs did not appear in editor).

Now, with the plugin deactivated, no new posts are able to be received/viewed in the app (but existing posts are OK).

What is the different between the plugin and what is now done natively in core and what can we do to get back the bits of the plugin than mace the post to app work?

I am not a coder so am very happy to freelance this out to someone to fix for us.
what is API ?
Here, check this out!


File Extensions and File Formats

Powered by: