Does anyone have an example of a "Well Defined" REST Web Service?

Question

I read tons of posts, questions and answers on REST and SOAP discussions. I read a few REST supporters who claim that "well-designed" REST web services are clear and hardly need documentation.

Can someone point me to such a web service? Preferably somewhat complicated.

Answer 1

Here is an example of a complex API for a network video camera ... I recommend looking at the VAPIX HTTP 3.0 API. It is quite simple to follow if you are familiar with the conditions. Of course, this is about 60 pages, but most of them are just a template to read the reader using the network API.

Yahoo! Weather channels are an example of a simple, RESTful way to retrieve information from a service.

There are also examples of REST APIs that essentially send XML-structured data back and forth. Although this is technically REST, if you are having difficulty defining an API using XML, I would consider using web services .

Answer 2

Netflix, , API. API , , .

API REST , ​​ , , REST (GET, PUT, DELETE). , RESTful, URL- , URL- . HATEOAS. "/employee" :

<employees>
  <employee id=132 name=bob url="/employee/132" employer="/employer/176"/>
  <employee id=179 name=carl url="/employee/132" employer="/employer/122"/>
</employees>

/employee/ 132 //176. , , bob PUT /employee/ 132 POST /employee. , ( HEAD, ).

Answer 3

Check out Amazon S3.