Live data from Hacker News

Best practices for REST API design (2020)

stackoverflow.blog

271–273 of 273 posts

Re: Best practices for REST API design (2020)

#271
post #250

Earlier quoted context omitted.

> Please, just don't do it. Yes, I read the dissertation. It's just not a good idea, it has never given me any practical use whatsoever and has always made dealing with the API more annoying. If you believe REST is not a good idea then you never had to deal with versioning and struggling to keep clients and servers you don't own to play nice. Asserting that something like REST has no practical purpose is asserting th…

I'm totally fine with calling it RPC-over-HTTP, or RESTless, or unREST. I'm also fine with just calling it REST. I don't care. I'm not fine with making an API use HATEOAS, especially not for the sake of being pedantically accurate about the word REST. As for your defense of HATEOAS, you're not doing a good job. If it's such a good idea, why is pretty much nobody doing it as intended? How exactly does it help with ver…

> I'm not fine with making an API use HATEOAS

And that's perfectly fine, but don't call what you're doing REST because it really isn't.

Re: Best practices for REST API design (2020)

#272
post #271

Earlier quoted context omitted.

I'm totally fine with calling it RPC-over-HTTP, or RESTless, or unREST. I'm also fine with just calling it REST. I don't care. I'm not fine with making an API use HATEOAS, especially not for the sake of being pedantically accurate about the word REST. As for your defense of HATEOAS, you're not doing a good job. If it's such a good idea, why is pretty much nobody doing it as intended? How exactly does it help with ver…

> I'm not fine with making an API use HATEOAS And that's perfectly fine, but don't call what you're doing REST because it really isn't.

This is a semantic dispute. Our disagreement is on whether this is a dispute worth arguing over.

There are many other industry buzzwords like "object oriented" that don't match up with what the people who coined the term had in mind. It's a nuisance, but nothing to get worked up over.

Re: Best practices for REST API design (2020)

#273

Earlier quoted context omitted.

Omg I love the browsable api of Django. I am searching for something similar for .NET - any pointers anyone?

https://swagger.io/tools/swagger-ui/ :)

That's not browsable. Swagger is just a prefilled Postman. I mean some UI where I can navigate and discover the resources directly.
Post reply on HN