Comment 2 for bug 711718

Revision history for this message
Martin Pool (mbp) wrote :

Primarily 1- http://en.wikipedia.org/wiki/HATEOAS (great acronym)

> The HATEOAS constraint is an acronym for Hypermedia as the Engine of Application State. This principle is the key differentiator between a REST and most other forms of client server system. Rather than the actions and interfaces a client may use being defined elsewhere, such as in a WSDL file or predefined in the client code, the principle is that the hypermedia in each server response will contain links that correspond to all the actions that the client can currently perform.

So in this case it would be better for eg the person object to point to its assigned bugs, rather than you needing to know you can call a method on the person.

2- Calling a method when a collection link would do just as well is more like rpc than rest.

3- It's inconsistent with the namespace space exposed through the web ui, eg <https://bugs.launchpad.net/~mbp/+assignedbugs>, and generally correspondence is seen as useful in rest.