Linked Data API Vocabulary
type: Ontology
comment: Configuration vocabulary for the Linked Data API
maker: Leigh Dodds
maker: Jeni Tennison
maker: Dave Reynolds
created: 2010-01-04
modified: 2010-02-19

Leigh Dodds
type: Person

Jeni Tennison
type: Person

Dave Reynolds
type: Person

API
type: Class

SPARQL endpoint
type: Property
comment: The endpoint used to serve up the results that are exposed by the API. This should not include the query parameters within the URI.
domain: API
range: Resource

Base URI
type: Property
comment: The base URI of the API, which is distinct from the URI of the SPARQL endpoint that it queries or the base URI of the instances that it returns. This base URI is stripped from the request URI before any matching is done against the endpoints defined for the API.
domain: API
range: Literal

Content Negotiation
type: Property
comment: The mechanism used within the URI to override normal content negotiation and deliver a particular results format.
domain: API
range: Content negotiation type

Vocabulary
type: Property
comment: A vocabulary that should be used by the configuration to provide labels for properties. To be recognised for filtering, a property must be defined either within this vocabulary or in the configuration file itself.
domain: API
range: Resource

Maximum Page Size
type: Property
comment: The maximum size of lists that will be returned by the API.
domain: API
range: integer

Default Page Size
type: Property
comment: The default size of lists that will be returned by the API or endpoint.
range: integer

Content negotiation type
type: Class

Suffix-Based Content Negotiation
type: Content negotiation type
comment: This content negotiation strategy uses the suffix used on the last segment within the request URI to indicate the formatter that should be used to format the results of the request.

Parameter-Based Content Negotiation
type: Content negotiation type
comment: This content negotiation strategy uses the _format parameter within the URI to indicate the formatter that should be used to format the results of the request.

Endpoint
type: Property
comment: An endpoint specified by the API, against which requests can be made.
domain: API
range: Endpoint

Endpoint
type: Class
comment: An endpoint exposed by the API.

Item Endpoint
type: Class
comment: An endpoint that returns information about a single instance.
subclass of: Endpoint

List Endpoint
type: Class
comment: An endpoint that returns information about a list of instances.
subclass of: Endpoint

URI template
type: Property
comment: A template that can be used to match against request URIs. This template can contain variable names within {}s; when the URI is matched then the substrings that appear in these locations are bound to the named variable.
domain: Endpoint
range: Literal

Item template
type: Property
comment: A template for the URI of the item that the item endpoint should return. Any instances of {varName} within the string are replaced by the value of the relevant variable.
domain: Item Endpoint
range: Literal

Selector
type: Property
comment: The selector that should be used to generate the list of items.
domain: List Endpoint
range: Selector

Viewer
type: Property
comment: A viewer that can be used with the endpoint.
domain: Endpoint
range: Viewer

Default Viewer
type: Property
comment: The default viewer used if none is explicitly selected within the request URI.
domain: Endpoint
range: Viewer

Formatter
type: Property
comment: A formatter that can be used with the endpoint.
domain: Endpoint
range: Formatter

Default Formatter
type: Property
comment: The default formatter used if none is explicitly selected within the request URI.
domain: Endpoint
range: Formatter

Selector
type: Class
comment: A specification of an ordered list of resources.

Parent
type: Property
comment: The parent selector, from which filters and sort specifications may be inherited.
domain: Selector
range: Selector

Select
type: Property
comment: A SPARQL WHERE and ORDER BY clause that can be used to select an ordered list of resources. It should include the binding of an ?item variable for the selected items.
domain: Selector
range: PlainLiteral

Where
type: Property
comment: A GroupGraphPattern suitable for embedding within a SPARQL WHERE clause. This is used for filtering the set of items that the selector selects.
domain: Selector
range: PlainLiteral

Order By
type: Property
comment: A space separated sequence of OrderConditions suitable for using in a SPARQL ORDER BY clause. This is used to order the sequence of items that the selector selects.
domain: Selector
range: PlainLiteral

Filter
type: Property
comment: A set of parameter bindings in the same format as is used within the query of a URI, used to provide a simple way of filtering the sequence of items that the selector selects.
domain: Selector
range: PlainLiteral

Sort
type: Property
comment: A sequence of comma-separated sort specifications indicating the sorting of the items in the sequence that the selector selects. A leading hyphen indicates a reverse sort.
domain: Selector
range: PlainLiteral

Viewer
type: Class
comment: A specification of a view of a particular item.

DESCRIBE Viewer
type: Viewer
comment: A viewer that returns a graph created from a DESCRIBE query.
Name: describe

Labelled DESCRIBE Viewer
type: Viewer
comment: A viewer that returns the graph created from a DESCRIBE query, supplemented by labels for linked resources.
Name: labelledDescribe

Basic Viewer
type: Viewer
comment: A viewer that returns the type and label of the item.
Name: basic
Property: label
Property: type

Name
type: Property
comment: The name of the resource.
range: PlainLiteral

Include
type: Property
comment: Other viewers that describe properties that should be incorporated into this view.
domain: Viewer
range: Viewer

Template
type: Property
comment: SPARQL that can be used to construct a graph based on an item (identified in the SPARQL as ?item).
domain: Viewer
range: PlainLiteral

Property
comment: A property chain (which may be a single property) that indicates information that should be included in the view.
domain: Viewer
range: Resource

Properties
type: Property
comment: A comma-separated list of property paths that indicate the information that should be included in the view.
domain: Viewer
range: PlainLiteral

Formatter
type: Class
comment: A formatter that creates a representation from an RDF graph.

Mime Type
type: Property
comment: The mime type that the formatter returns and that it should be used with.
domain: Formatter
range: PlainLiteral

RDF/XML Formatter
type: Class
comment: A formatter that generates an RDF/XML representation of an RDF graph
subclass of: Formatter

Default RDF/XML Formatter
type: RDF/XML Formatter
comment: A formatter that gives the default RDF/XML representation of an RDF graph

Turtle Formatter
type: Class
comment: A formatter that generates an Turtle representation of an RDF graph
subclass of: Formatter
label: Default Turtle Formatter
comment: A formatter that gives the default Turtle representation of an RDF graph

JSON Formatter
type: Class
comment: A formatter that generates a simple JSON representation of an RDF graph
subclass of: Formatter

Default JSON Formatter
comment: A formatter that gives the default simple JSON representation of an RDF graph

XML Formatter
type: Class
comment: A formatter that generates a simple XML representation of an RDF graph
subclass of: Formatter

Default XML Formatter
comment: A formatter that gives the default simple XML representation of an RDF graph

CSV Formatter
type: Class
comment: A formatter that generates a simple CSV representation of an RDF graph
subclass of: Formatter

Default CSV Formatter
comment: A formatter that gives the default simple CSV representation of an RDF graph

XSLT Formatter
type: Class
comment: A formatter that uses an XSLT stylesheet to generates a representation of an RDF graph
subclass of: Formatter

Stylesheet
type: Property
comment: The XSLT stylesheet that should be used by an XSLT formatter to generate a representation of the RDF graph
domain: XSLT Formatter
range: Resource

Definition
type: Property
comment: The API Endpoint
domain: List

Items
type: Property
domain: Page
range: List
comment: The list of resources described by the page that are in the List the page is part of.

List
type: Class
comment: a List represents the full set of resources that match the request against the Endpoint; a Page lists a subset of the List.

Page
type: Class
comment: A page returned in response to a request to an Endpoint.

Extended Metadata Version
type: Property
comment: a document containing the same data, plus extra document-centric metadata.
range: Page
domain: Page