Zelestra

Zelestra Standards

get

The get operation returns resource metadata formatted as RDF.

Request

The get operation requires a message that consists of a single GetRequest element.

Examples

URL Encoded:
uri=http://www.zelestra.com/kangaroos.jpg

XML:
<GetRequest>
  <URI>http://www.zelestra.com/kangaroos.jpg</URI>
</GetRequest>

The GetRequest element MUST contain a URI element, which is the URI of a resource.

The GetRequest element MAY contain one or more Include elements, which are used to include only specific metadata information (see below).

The GetRequest element MAY contain one or more Exclude elements, which are used to exclude specific metadata information (see below).

The Include and Exclude elements may be formatted as one, two, or three comma separated fields as follows:

  • predicate
  • predicate,scheme
  • predicate,scheme,locale

Scheme and locale may be empty strings, predicate may not be an empty string. Predicates and Schemes are formatted as XML qualified names. Locales follow RFC1766 language designations.

Operation

Metadata for the specified resource is retrieved and returned.

Response

The get operation returns an RDF document.

Faults

The get operation may return a badRequest fault if the request parameter is invalid.

The get operation may return a forbidden fault if the requestor does not have the appropriate permission.

The get operation may return a notFound fault if the specified resource does not exist.

The get operation may return an unauthorized fault if the requestor has not previously authenticated.

The get operation may return an operationFailed fault if the service was unable to otherwise fulfill the request.