DEV Community

Sreekar Reddy
Sreekar Reddy

Posted on Originally published at sreekarreddy.com

๐Ÿ“ฎ REST API Explained Like You're 5

Web services using HTTP verbs

Day 128 of 149

๐Ÿ‘‰ Full deep-dive with code examples


The Library Analogy

A library with standard commands:

  • GET a book - Receive book
  • POST a book - Donate new book
  • PUT a book - Replace with updated version
  • DELETE a book - Remove from library

REST APIs use the same HTTP verbs to operate on resources.


HTTP Methods = CRUD

Method Action Example
GET Read GET /users
POST Create POST /users
PUT Update PUT /users/1
DELETE Delete DELETE /users/1

Real Example

// Get all users
const users = await fetch("/api/users");

// Create user
await fetch("/api/users", {
  method: "POST",
  body: JSON.stringify({ name: "Alice" }),
});
Enter fullscreen mode Exit fullscreen mode

Best Practices

  • Use nouns, not verbs (/users not /getUsers)
  • Use plurals (/products not /product)
  • Return proper status codes (200, 201, 404, etc.)

In One Sentence

REST APIs use standard HTTP methods (GET, POST, PUT, DELETE) to interact with resources identified by URLs.


๐Ÿ”— Enjoying these? Follow for daily ELI5 explanations!

Making complex tech concepts simple, one day at a time.

Top comments (0)