What is "Linking Resources" in RestEasy?

Question

I am studying on Resful web services with RestEasy API. In docs of API at chapter 8 there is a topic called "Linking Resources." I read that chapter several times and I can not understand what it is. What is linking resources? What can we do with it? Why do we need it?

Answer 1

I believe it refers to level 3 of the Richardson Maturity Model:

Hypermedia – resources contain links to related resources and collections, and also links to perform actions on the resources themselves. APIs are now self-documenting and discoverable.

As to why do we need it, here's a much more details answer than I could ever write.

Of course, all these are theoretical notions - but at the same time your question doesn't seem to be too tightly coupled to the actual RestEasy implementation details.