frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

Open in hackernews

REST Is for Humans, Not for APIs

https://jabbawookiees.bearblog.dev/rest-is-for-humans-not-for-apis/
3•jabbawookiees•11h ago

Comments

almosthere•7h ago
Agreed. My take:

It kinda had always been comical to me that people around 2003 - 2010 were non-stop citing Fielding's paper as if he envisioned REST APIs that worked with JSON. No one actually citing the paper cared at all to read it - but skimmed it or read someone else's notes on it.

Then eventually everyone went crazy thinking their REST Api was supposed to be human readable and started adding Links to the response... and then HATEOAS was born. And it went everywhere in talks at JavaWorld and whatever else was the hot shit back in the day.

People started talking about how they would transfer money from their various bank accounts in Curl or renewing their drivers license by carefully crafting their own JSON payload by hand.

I grabbed sanity by the horns early and decided that none of it is meant for humans and rode the internet age as a developer not making more talks on PERFECT RESTFUL PATHS. I just kind of got by in meetings where people argued 30 minutes at a time about the path, slightly rolling my eyes thinking "oh gawd these are the people with a Sublime instance open with a giant DMV renewal they've been working on for weeks".

When GQL came out, I was just happy something was going to murder REST once and for all.

I think the most annoying thing about REST is the number of ways you can transmit data or intent:

  1. Method
  2. Query
  3. Path
  4. Headers
  5. Payload
  (probably more)
And to understand the response you need to look at:

  1. Status codes
  2. Payload
  3. Redirections
  4. Continuations. egh
  5. Headers again
The reason swagger/openapi is so shitty (or at least took about 20 years to become stable) is because of that.

Finally just moving a bit more into the practicality - there is nowhere in the OSI stack where the next layer up (or down depending on how you see it) cares a whole lot about the layer before it. And that's on purpose. TCP doesn't care what PORT you're running on in IP land. Yet for some reason everyone stopped thinking when HTTP was invented that it was specifically to help with WEB PAGES. It was not invented for APIs. I think GQL is a much better abstraction, and while it's bound to Http, in a sense- it can easily be repackaged on top of a different protocol in the future just by moving 1 or 2 things (mostly headers for auth).

I HATE REST

Ask HN: PMs working in foundational AI companies – what have you learned?

1•pinter69•41s ago•0 comments

A.I. Is Making Sure You Pay for That Ding on Your Rental Car

https://www.nytimes.com/2025/07/09/travel/rental-car-ai-scanner-hertz.html
1•sega_sai•4m ago•1 comments

Dark mode is not just about aesthetics

https://drgrizz.xyz/dark-mode.html
1•hosteur•7m ago•0 comments

Europe is slowly ditching Microsoft: why it's happening and why it could fail [video]

https://www.youtube.com/watch?v=RGt2pZg7dJY
3•unripe_syntax•9m ago•1 comments

Smarter Use of Stimulus' Action Parameters

https://railsdesigner.com/smarter-action-parameters/
1•amalinovic•10m ago•0 comments

Anthropic Courses

https://anthropic.skilljar.com
1•tzury•10m ago•0 comments

About Clew

https://clew.se/about/
1•todsacerdoti•11m ago•0 comments

A Century of Quantum Mechanics

https://home.cern/news/news/physics/century-quantum-mechanics
1•bookofjoe•11m ago•0 comments

AI Trip-Prep Toolkit

https://twitter.com/TenZorroAI/status/1943247022456205443
1•paulo20223•14m ago•0 comments

Foundation Models on iOS 26 aren't usable so far in tests

https://twitter.com/benguild/status/1943255426142998705
1•benguild•15m ago•0 comments

Async Ruby Is the Future of AI Apps (and It's Already Here)

https://paolino.me/async-ruby-is-the-future/
1•thunderbong•16m ago•0 comments

AI model predicts what humans will do next, and it's shockingly accurate

https://studyfinds.org/ai-thinks-like-humans-unprecedented-accuracy/
1•geox•20m ago•0 comments

Ask HN: What did you hate when building an MCP server?

1•shubhamintech•21m ago•0 comments

Which Workers Will A.I. Hurt Most: The Young or the Experienced?

https://www.nytimes.com/2025/07/07/business/ai-job-cuts.html
1•helsinkiandrew•22m ago•2 comments

The underground cathedral protecting Tokyo from floods

https://www.bbc.com/future/article/20181129-the-underground-cathedral-protecting-tokyo-from-floods
2•barry-cotter•22m ago•0 comments

Lubeno: A Code Hosting Platform Built Around Jj

https://lubeno.dev/
1•sbt567•25m ago•0 comments

AWS Marketplace: Cerebras Inference Cloud

https://aws.amazon.com/marketplace/pp/prodview-ojnugptcivbeg
1•rbanffy•29m ago•0 comments

How We Built a Streaming SQL Engine

https://www.epsio.io/blog/how-to-create-a-streaming-sql-engine
1•rbanffy•30m ago•0 comments

Loosely synchronize your JavaScript stores in multiple Tauri processes

https://www.gethopp.app/blog/tauri-window-state-sync
2•vasi9510•31m ago•0 comments

Pet Pet Generator

https://petpetgenerator.net
1•MintNow•35m ago•1 comments

Are We at Logarithmic Midpoint of Extraterrestrial Technological Civilizations?

https://avi-loeb.medium.com/are-we-at-the-logarithmic-midpoint-of-extraterrestrial-technological-civilizations-5ab0f7a5dc5f
2•bryanrasmussen•36m ago•0 comments

Show HN: NotebookLM Web Importer

https://chromewebstore.google.com/detail/notebooklm-web-importer/ijdefdijdmghafocfmmdojfghnpelnfn
2•wonderfuly•37m ago•0 comments

Building Modular Interpreters and Visitors in Rust with Extensible Variants and

https://contextgeneric.dev/blog/extensible-datatypes-part-2/
1•todsacerdoti•39m ago•0 comments

Waking in the Night, Angry and Alert

https://medium.com/luminasticity/waking-in-the-night-angry-and-alert-778483399e55
1•bryanrasmussen•40m ago•0 comments

American men are hungry for injectable testosterone

https://www.economist.com/united-states/2025/07/08/american-men-are-hungry-for-injectable-testosterone
1•bookofjoe•41m ago•2 comments

Show HN: AI Card Genius(iOS) – Instantly Create Flashcards with AI

https://apps.apple.com/gr/app/ai-card-genius/id6746345518
1•AGINestedCorp•41m ago•0 comments

First Cadillac Celestiq Owner Is Already Enjoying Their Bespoke $340k EV

https://www.jalopnik.com/1907965/first-cadillac-celestiq-bespoke-ev-spotted-parked-like-normal-car/
1•Bluestein•42m ago•0 comments

Figma's $300k Daily AWS Bill Highlights Cloud Dependency Risks

https://www.infoq.com/news/2025/07/figma-aws-300k-daily-bill/
3•e2e4•44m ago•0 comments

Show HN: Cartlink – Monetize Influencer Content Without Changing a Thing

https://www.cartlink.app
1•maclark25•47m ago•0 comments

Show HN: Built a desktop app to organize photos locally with duplicate detection

https://organizer.flipfocus.nl/
1•mcvanhassel•50m ago•1 comments