Calling your web API “RESTful”? You’re doing it wrong

#1

Post by tn6o » Wed, May 11, 2016, 10:46 AM UTC

Calling your web API “RESTful”? You’re doing it wrong
samurails.com

Re: Calling your web API “RESTful”? You’re doing it wrong

#2

Post by alistproducer2 » Wed, May 11, 2016, 11:31 AM UTC

I found this (http://www.restapitutorial.com/lessons/whatisrest.html#) to be a better explanation.

Re: Calling your web API “RESTful”? You’re doing it wrong

#3

Post by tn6o » Wed, May 11, 2016, 12:17 PM UTC

alistproducer2 wrote: post #2

I found this ( http://www.restapitutorial.com/lessons/whatisrest.html# ) to be a better explanation.

The link you gave is pretty good. Note however, that in this article I wasn't trying to explain in details what is REST.

What I want is more to let people know why their APIs are not RESTful so they can use the kind of resources you gave to actually learn more about REST.

Thanks for sharing!

Re: Calling your web API “RESTful”? You’re doing it wrong

#4

Post by BerislavLopac » Wed, May 11, 2016, 1:39 PM UTC

There is something called "Richardson maturity model", which pretty clearly specifies different levels of "restfulness": http://martinfowler.com/articles/richardsonMaturityModel.htm...

Re: Calling your web API “RESTful”? You’re doing it wrong

#5

Post by tn6o » Wed, May 11, 2016, 1:46 PM UTC

BerislavLopac wrote: post #4

There is something called "Richardson maturity model", which pretty clearly specifies different levels of "restfulness": http://martinfowler.com/articles/richardsonMaturityModel.htm...

Yes, I know about this model but it wasn't made by Fielding and he made his positions pretty clear about what's RESTful and what's not.

I do agree that this model is a good set of steps to build better APIs but then, how do you call them? RESTful Level 1 API?

My point with this article is just to call API what they are (usually just HTTP APIs). I'm totally against the use of the REST buzzword these days since it doesn't mean much anymore: everyone has a different view on it.

Re: Calling your web API “RESTful”? You’re doing it wrong

#6

Post by alistproducer2 » Wed, May 11, 2016, 3:56 PM UTC

tn6o wrote: post #3

alistproducer2 wrote: post #2

I found this ( http://www.restapitutorial.com/lessons/whatisrest.html# ) to be a better explanation.

The link you gave is pretty good. Note however, that in this article I wasn't trying to explain in details what is REST. What I want is more to let people know why their APIs are not RESTful so they can use the kind of resources you gave to actually learn more about REST. Thanks for sharing!

I went and found this resource as a result of reading your article. Your write up had the intended effect :)