O'Reilly logo
  • Dan Sanders thinks this is interesting:

HAL, Collection+JSON, …

Now that we’ve reached the end of the chapter, you may be thinking that we’ve exaggerated the level of discoverability available in a REST-based API. After all, the server doesn’t appear to be “providing all of the information necessary to compose requests,” as we advertised back in the “XML-RPC and SOAP” section. For example, one can’t create a Task without knowing what attributes are required, and nothing we’ve seen thus far in the server responses provides this information.

Well, this is one of those cases where a little bit of pragmatism ...