This project is read-only.

Link Aggregate - Resourceful way of linking resources HATEOS and HAL

Topics: JSON, Messages, Resources, REST
Sep 20, 2016 at 8:56 PM
Another new addition is the <Link> element.

This new aggregate will be the first thing you find in every resource.

The result is a much more navigable API with simple HTTP links between resources.

Here is a small sample of XML to illustrate the usage:
    <Link rel="self" href="/policy/4e068b48-798c-4df1-8d1d-ea2a90f4eb4c" title="Self" />
    <Link rel="next" href="/policy/4e068b48-798c-4df1-8d1d-ea2a345eb4d" title="Next" />
    <Link rel="last" href="/policy/4e068b48-798c-4df1-8d1d-ea2a90f4eb4c" title="Last" />
We still need to define the valid values for @rel, but the above structure will support HATEOS and HAL based interfaces.
Sep 20, 2016 at 9:28 PM
I have created a OPENAPI JSON Schema for the Link aggregate.

OpenAPI Specification