News for hackers. Stuff that matters.

REST Introduction

Does anybody know a short introduction to REST APIs ? I know HTTP reasonably well (it is not that complicated after all, I dare to say) and I need to know specifically what REST is about. I understand that being ignorant on the matter does not help in selecting a good source, but I've found all books (PDFs) on the internet excessively long, 300 pages+. Is it me overlooking the topic - because I don't know what I am talking about - or are they truly excessive ?

Any recommendations ?

( 12 comments | 24 points | on HN )
Re:REST Introduction by highhedgehog on Tuesday April 23, 2019 @10:38AM (#19729043)
Re:REST Introduction by jermaustin1 on Tuesday April 09, 2019 @12:48PM (#19616570)
Microsoft has a decent document regarding REST API design[1]. The main gist is, HTTP Verbs tell the application what to do with the object the URI Path points to.

1: https://docs.microsoft.com/en-us/azure/architecture/best-pra...

Re:REST Introduction by ameyv on Tuesday April 09, 2019 @02:16PM (#19617503)
If you wish to see everything in one single doc page.

https://github.com/Microsoft/api-guidelines/blob/vNext/Guide...

Re:REST Introduction by pulsarpietro on Wednesday April 10, 2019 @04:40AM (#19622875)
Thanks all, this is probably a very good starting point
Re:REST Introduction by kody on Tuesday April 09, 2019 @12:07PM (#19616095)
I strongly recommend Designing Web APIs: http://shop.oreilly.com/product/0636920123880.do

You can jump ahead to the Representational State Transfer chapter to get a good overview of REST, then read whichever chapters seem interesting or solve whichever problems you're facing.

Re:REST Introduction by pulsarpietro on Tuesday April 09, 2019 @12:17PM (#19616213)
Can't find that chapter here: https://www.amazon.com/Designing-Web-APIs-Building-Developer...

am I looking at a the right edition ?

Re:REST Introduction by kody on Tuesday April 09, 2019 @02:17PM (#19617514)
Sorry, it's under Chapter 2. API Paradigms / Request-Response APIs / Representational State Transfer
Re:REST Introduction by macca321 on Tuesday April 09, 2019 @05:15PM (#19618994)
There's two kinds of REST. REST as most developers misunderstand it, and REST as Roy Fielding, inventor of REST, understands it.

For the former you can read the Microsoft REST guidelines, for the latter I suggest getting Mike Amundsen's RESTful Web APIs book.

If you do go with the latter be prepared for a lot of frustration with those who went with the former.

Re:REST Introduction by Something1234 on Tuesday April 09, 2019 @08:58PM (#19620667)
Can you explain what is wrong with most people's implementation of rest?
Re:REST Introduction by macca321 on Wednesday April 10, 2019 @06:47AM (#19623415)
Re:REST Introduction by macca321 on Wednesday April 10, 2019 @10:26AM (#19624955)
Re:REST Introduction by santypk4 on Tuesday April 09, 2019 @10:12PM (#19621163)
Check this site https://restfulapi.net/ It has information about RESTful API Designs, HATEOAS, Caching, Compression, etc. Very useful