Understanding the Basics of REST APIs
Mohamed Riham

Mohamed Riham @mohamed-riham

About: Data Science Undergraduate | AI & ML Developer | Cloud & Intelligent Automation Enthusiast | Researcher | Developer

Location:
Addalaichenai, Sri Lanka
Joined:
May 12, 2025

Understanding the Basics of REST APIs

Publish Date: May 24
30 8

🌐 Understanding the Basics of REST APIs

If you’ve ever used a weather app or fetched data from a website, chances are you’ve interacted with a REST API. But what exactly is a REST API? And why is it so essential in today’s web development world?

Let’s break it down step by step.


🤔 What is an API?

An API (Application Programming Interface) is like a waiter at a restaurant. You (the client) tell the waiter what you want (make a request), the waiter takes it to the kitchen (server), and then brings back your food (the response).

In tech terms, an API allows two software systems to communicate with each other.


🔄 What is REST?

REST (Representational State Transfer) is a set of rules and conventions for building web APIs. RESTful APIs use standard HTTP methods to perform actions on resources.

The 4 most common HTTP methods are:

  • GET - Retrieve data
  • POST - Create new data
  • PUT - Update existing data
  • DELETE - Remove data

🧱 REST API Example

🛠️ Tools to Try It Out

🧠 Final Thoughts

REST APIs are everywhere. Understanding how they work is a key skill for modern developers. Once you grasp the basics, you can build full-stack apps that talk to servers, fetch live data, and power real-world features.

Comments 8 total

  • Tech Halwa Channel
    Tech Halwa ChannelMay 24, 2025

    Great write-up, Mohamed Riham! 🌟
    You’ve done a solid job breaking down the fundamentals of REST APIs in a beginner-friendly way. The analogy of the waiter really helps clarify how APIs work behind the scenes — simple yet effective! 🙌

    It might be helpful for new readers if you also briefly touch on the concept of status codes (like 200 OK or 404 Not Found), since they're often the first feedback developers get when testing APIs.

    Looking forward to more posts like this — maybe one on authentication in REST APIs next? 😄

    Keep sharing your knowledge!

    • Mohamed Riham
      Mohamed RihamMay 26, 2025

      Thank you so much! 🙏 I'm really glad the waiter analogy helped it’s one of my go-to ways of simplifying complex concepts for beginners.

      That’s a great suggestion about HTTP status codes! I’ll definitely consider updating the article or creating a follow-up post that covers status codes and maybe even touches on authentication, as you mentioned.

      Really appreciate your thoughtful feedback — more content coming soon! 🚀

  • Dotallio
    DotallioMay 25, 2025

    Great intro! Learning to use Postman for the first time totally changed how I understood APIs. Do you remember what your first real API project was?

    • Mohamed Riham
      Mohamed RihamMay 26, 2025

      Thanks a lot! 🙌 Postman really helped me understand the full flow of requests and responses too.

      My first real API project was actually a voice assistant chatbot I built. It used REST APIs for things like fetching weather data and converting voice to text using external services. Super fun and a great learning experience!

      What was your first project with APIs? Would love to hear! 😊

  • Nathan Tarbert
    Nathan TarbertMay 26, 2025

    Nice, helped me finally get why everyone talks about REST APIs all the time. Making progress step by step over here.

Add comment