𝐖𝐡𝐚𝐭 𝐦𝐚𝐤𝐞𝐬 𝐚𝐧 𝐀𝐏𝐈 “𝐑𝐄𝐒𝐓𝐟𝐮𝐥”? Not every API that returns JSON is RESTful. REST is not about technology. It’s about design principles. Let’s simplify it 👇 𝟏. 𝐑𝐞𝐬𝐨𝐮𝐫𝐜𝐞𝐬 (Not actions) Your URLs should represent nouns. Good: → GET /notes → DELETE /notes/5 Not: → GET /getNotes → POST /deleteNote APIs describe resources. HTTP methods describe actions. 𝟐. 𝐒𝐭𝐚𝐭𝐞𝐥𝐞𝐬𝐬 Each request must contain everything the server needs. → No hidden memory. → No dependency on previous calls. Every request stands on its own. That’s what makes systems scalable. 𝟑. 𝐑𝐞𝐩𝐫𝐞𝐬𝐞𝐧𝐭𝐚𝐭𝐢𝐨𝐧 (Usually JSON) The client and server exchange structured data. → Not HTML pages. → Not server-rendered views. Clean, predictable data structures. Here’s the simple formula: Resources → identified by URLs Actions → defined by HTTP methods State → not stored between requests If your API follows these rules, it’s not just working ... 👉 It’s well designed. 𝐏𝐒: Next, I’ll show how I built a Notes API using in-memory storage and what breaks when multiple requests hit the server. Follow Fatima Hamid for simple, practical lessons that scale from UI to systems. . . . ➥ Tags: Mian Ahmad Basit #NodeJS #BackendDevelopment #APIDesign #WebDevelopment #SoftwareEngineering #RESTAPI #JavaScript #FullStackDeveloper
Thanks for sharing
Love how you simplified REST, resources, statelessness, representation. Clear design principles > just returning JSON
The point about statelessness is often the hardest concept for newer developers to grasp, but it is the most critical for scaling
The things that feel elegant in code are often the result of a lot of silent decisions around consistency and usability. Fatima Hamid
building APIs that actually follow these principles is way harder than it sounds, especially when you're dealing with review data and trying to balance performance with data consistency, we've had to get creative with caching and queueing to make sure our review infrastructure doesn't buckle under load
Spot on! For statelessness, consider mentioning the importance of tokens or session management for user context.
Nouns in URLs. Verbs in methods. Fatima Hamid
Great explanation. REST is really about discipline in design once you get resources and statelessness right, everything else becomes much more predictable and scalable.