Work in progress: 181,232 of 181,233 sites checked so far, more every week · updated 2 Nov 2026Missing a blog? Tell us

Top all-time · #6733

A

Arnaud Lauret

Personal blog · apihandyman.iowebprogrammingcareer

Arnaud Lauret writes API Handyman, a personal blog at apihandyman.io about web, programming and career. Since 2015, 12 different Hacker News readers have linked it 16 times, most often “Do you really know why you prefer REST over RPC?”. The last post was in 2022, but the archive is still widely read.

Visit the blog
16mentions?
12HN people?
2015–2021first – last linked?
Links on Hacker News per year · peak 7 in 2021

Too few sampled comments (4) to say how often HN recommends it.?

Why HN links it

HN readers link Arnaud Lauret's API posts, mainly his jq tutorial for working with OpenAPI specs, which one commenter calls the most useful tutorial for that. Another calls a Swagger tutorial fantastic.

Summarised by Claude from a sample of 4 HN comments that link here. Each comment is marked recommending, critical or neutral (citing without judging); how this works.

Hi! I'm Arnaud Lauret, the API Handyman and author of The Design of Web APIs. I like to share what I do, struggle with, learn, and teach while working in the API space.

Most-linked posts?

  1. Do you really know why you prefer REST over RPC?
    3 people · 3 mentions · first linked 2017-03-22
  2. Do you really know why you prefer REST over RPC?
    2 people · 2 mentions · first linked 2015-05-11

What Hacker News says?

  1. The full link: https://apihandyman.io/api-toolbox-jq-and-openapi-part-1-usi...

    Comment linking /api-toolbox-jq-and-openapi-part-1-using-jq-to-extract-data-from-openapi-files/

    on “An Introduction to JQ”
  2. Submitted Do you really know why you prefer REST over RPC? as a story · 111 points

    HN discussion
  3. stueynz · 2021-08-25Recommends
    My OpenAPI spec is 60,000 lines of machine generated goodness. JQ is great for doing non-trivial but useful things. Eg: Which endpoints are available if you have a specific OAuth Scope? Most useful jq cli flag is -f. - take the jq script from file Most useful tutorial for learning to manipulated your OpenAPI spec https://apihandyman.io/api-toolbox-jq-and-openapi-part-1-usi ...

    Comment linking /api-toolbox-jq-and-openapi-part-1-usi

    on “An Introduction to JQ”
  4. Submitted And GraphQL for all? A few things to think about before blindly dumping REST as a story · 3 points

    HN discussion
  5. It is amazing to me that almost nobody here actually questioned the wisdom of throwing out the time tested benefits of robustness of REST in exchange for that which REST was created to eliminate; the fragility of RPC. And all because using RPC is easier in the moment (vs. over time.) This reminds of of the old saw "Those who ignore history are doomed to repeat it." If you are unaware of the benefits, here are a just…

    Comment linking /do-you-really-know-why-you-prefer-rest-over-rpc/

    on “Twirp: A new RPC framework for Go”
  6. Submitted Do you really know why you prefer REST over RPC? as a story · 3 points

    HN discussion
  7. Which editor do you use to edit Swagger? Writing Swagger specification by hand is a nightmare because of the poor online editor. The error messages are hard to understand. Also Swagger.io people decided to replace the old editor with the new editor and it doesn't have many useful features the old has. Thankfully they kept the old one live. Swagger is not all that hard to understand. This is a fantastic tutorial whic…

    Comment linking /writing-openapi-swagger-specification-tutorial-part-1-introduction/

    on “Swagger is now the OpenAPI Specification”
  8. Submitted Automate all the things with GitHub actions, Postman and APIs as a story · 2 points

    HN discussion
  9. Submitted HTTP status code 401 vs. 403 vs. 404 as a story · 2 points

    HN discussion
  10. Submitted Adopt and not assess OpenAPI linters in the Thoughtworks Radar as a story · 2 points

    HN discussion
  11. Submitted Do you really know why you prefer REST over RPC? as a story · 2 points

    HN discussion
  12. Submitted Do you really know why you prefer REST over RPC? as a story · 2 points

    HN discussion
  13. Submitted Empty list: HTTP status code 200 vs. 204 vs. 404 as a story · 1 points

    HN discussion
  14. Submitted 404 vs. 405 vs. 501 as a story · 1 points

    HN discussion
  15. Submitted Do you really know why you prefer REST over RPC as a story · 1 points

    HN discussion
  16. Submitted The beautiful API and the bestial back office, a comic as a story · 1 points

    HN discussion

Search all of HN for apihandyman.io