the idea that all you need is an endpoint and a set of media types is a complete myth—even if with a browser pointing to a web site. A client will need to understand the URI namespaces in use. In addition, because the media delivered through an API is generally some kind of structured XML or JSON, how to interpret that XML or JSON. That often includes understanding the relative naming within a URN/URL namespace for locating referenced objects.
