Link (XML)
A hypermedia link, used to drive the state of a hypermedia-enabled genealogical data application.
| Namespace: | http://gedcomx.org/v1/ |
| URI: | http://gedcomx.org/v1/Link |
Properties
| Name |
Type |
Description |
|
| template |
string
|
A URI template per RFC 6570, used to link to a range of
URIs, such as for the purpose of linking to a query. A link specifying a template can be formally referred to
as a "Templated Link (LT)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly. |
|
| allow |
string
|
Metadata about the allowable methods that can be used to transition to the resource being linked. The value of
the "allow" attribute is as defined by the HTTP specification, RFC 2616, Section 14.7.
Note that this attribute can be considered an "Method Control (CM)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly. |
|
| offset |
int
|
The index of the offset of the page, if this link refers to a page of resources. |
|
| count |
int
|
The number of elements in the page, if this link refers to a page of resources. |
|
| type |
string
|
Metadata about the available media type(s) of the resource being linked to. The value of the "type" attribute is
as defined by the HTTP specification, RFC 2616, Section 3.7.
Note that this attribute can be considered an "Update Control (CU)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly. |
|
| title |
string
|
Human-readable information about the link. |
|
| accept |
string
|
Metadata about the acceptable media type(s) that can be used to update (i.e. change the state of) the resource being linked to. The value of
the "accept" attribute is as defined by the HTTP specification, RFC 2616, Section 3.7.
Note that this attribute can be considered an "Read Control (CR)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly. |
|
| hreflang |
string
|
The language of the resource being linked to.
Note that this attribute can be considered an "Update Control (CU)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly. |
|
| rel |
string
|
The link relationship. |
|
| href |
anyURI
|
The target IRI of the link. |
|
| results |
int
|
The total number of results in the page to which this links, if this link refers to a page of resources. |
|
Example
<link accept="..." allow="..." count="..." href="..." hreflang="..." offset="..." rel="..." results="..." template="..." title="..." type="..." xmlns="http://gedcomx.org/v1/"/>