Hypermedia

From Hostway API Documentation
Revision as of 16:19, 5 February 2013 by Mike.robski (Talk | contribs)
Jump to: navigation, search

Hypermedia is used to describe the relationships between resources. It is suggested that clients use the hypermedia to browse between resource and not build URLs with templates.

JSON

In the JSON representation the hypermedia is included in the links field of the JSON object.

{
   "links":[
      {
         "href":"http://{api_server}/flavors/{flavor_id}/",
         "rel":"self"
      },
      {
         "href":"http://{api_server}/flavors/{flavor_id}/",
         "rel":"bookmark"
      }
   ]
}

href
The absolute URL of the resource.
rel
Describes the relationship of this resources to the resource at the href URL. See [1] for list of standard relationship types.
self - This is a link to the full version of this resource. Most listings will give a truncated version of the resource and include a self link.
bookmark - This is a permalink to the current stable API version of this resource.

See also

Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox