Link Aggregate - Resourceful way of linking resources HATEOS and HAL

Topics: JSON, Messages, Resources, REST
Coordinator
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:
<Resource>
    <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" />
</Resource>
We still need to define the valid values for @rel, but the above structure will support HATEOS and HAL based interfaces.
Coordinator
Sep 20, 2016 at 9:28 PM
I have created a OPENAPI JSON Schema for the Link aggregate.

Link JSON SCHEMA
OpenAPI Specification