CSS Stylesheet |
---|
h3 { background-color: #eee; padding: 0.6em; } #content .code { margin-left: 2.5em!important; background-color: #fafafa!important; } .pdl .syntaxhighlighter table td.code .container, .syntaxhighlighter .line.alt2, .syntaxhighlighter .line.alt1 { background-color: #fafafa!important; } |
...
Table of Contents
Expand | |
---|---|
|
Overview
...
Introduction
...
Excerpt |
---|
The Fedora 4 HTTP API is generally a RESTful API. HTTP methods like GET, PUT, POST and DELETE are implemented on most resource paths. The API also relies heavily on content negotiation to deliver context-appropriate responses, and a HATEOAS-driven text/html response (providing a decent GUI experience on top of the repository). |
The Fedora 4 RDF-based responses may be serialized as:
- application/n3 (or text/rdf+n3 or text/n3)
- text/turtle
- ld+json
- application/n-triples
- text/trig
- application/rdf+xmlapplication
- text/n3 (or text/rdf+jsonn3)
- text/plain
- text/turtle (or application/nx-quadsturtle)
The text/html response also includes embedded RDFa markup.
The API is based loosely around the Fedora 4 implements the Linked Data Platform 1.0 Architecture, which:
[...] describes the use of HTTP for accessing, updating, creating and deleting resources from servers that expose their resources as Linked Data. It provides clarifications and extensions of the rules of Linked Data [LINKED-DATA]:
- Use URIs as names for things
- Use HTTP URIs so that people can look up those names
- When someone looks up a URI, provide useful information, using the standards (RDF*, SPARQL)
- Include links to other URIs, so that they can discover more things
...
Changes planned
Asynchronous API support
Versioning
CND node types
Changelog
Endpoints
...
Resources
Repository objects can be loosely divided into two classes of resources:
- Object and containers Containers ("fedora:objectContainer"), containing RDF properties and 0 or more child nodesresources
- Binaries, containing any binary payload
Objects
Request URI: /path/to/some/resource
Methods: GET, POST, PUT, PATCH, DELETE, MOVE, COPY
Retrieve all triples for the resource Status title GET
Query Parameters:
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Request Headers:
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
...
Example (1):
Code Block |
---|
curl -H "Accept: text/turtle" "http://localhost:8080/rest/" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/turtle
Cache-Control:
Last-Modified-At: 2013-01-01T01:23:45Z
Link: http://localhost:8080/rest/?offset=0&limit=10;rel="first"
Link: http://www.w3.org/ns/ldp/Resource;rel="type"
Accept-Patch: application/sparql-update
Body:
<http://localhost:8080/rest/>
a <http://www.w3.org/ns/ldp#Container> , <http://www.w3.org/ns/ldp#Page> ;
<http://www.w3.org/ns/ldp#membersInlined>
"true" ;
<http://www.w3.org/ns/ldp#membershipObject>
<http://www.w3.org/ns/ldp#MemberSubject> ;
<http://www.w3.org/ns/ldp#membershipPredicate>
<http://fedora.info/definitions/v4/repository#hasChild> ;
<http://www.w3.org/ns/ldp#membershipSubject>
<http://localhost:8080/rest/> ;
<http://www.w3.org/ns/ldp#pageOf>
<http://localhost:8080/rest/> ;
<http://fedora.info/definitions/v4/rest-api#exportsAs>
<http://localhost:8080/rest//fcr:export?format=jcr/xml> ;
<http://fedora.info/definitions/v4/rest-api#hasNamespaces>
<http://localhost:8080/rest/fcr:namespaces> ;
<http://fedora.info/definitions/v4/rest-api#hasTransactionProvider>
<http://localhost:8080/rest/fcr:tx> ;
<http://fedora.info/definitions/v4/rest-api#hasWorkspaces>
<http://localhost:8080/rest/fcr:workspaces> ;
<http://microformats.org/wiki/rel-sitemap>
<http://localhost:8080/rest/sitemap> ; |
Example (2):
Code Block |
---|
curl -H "Accept: text/turtle" "http://localhost:8080/rest/path/to/resource" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
ETag: "d98e86c48a3e31857f5311f51ad7a2e13a7cedee"
Content-Type: text/turtle
Cache-Control: must-revalidate
Last-Modified: Fri, 15 Nov 2013 23:31:07 +0000
Link: http://localhost:8080/rest/path/to/resource/?offset=0&limit=10;rel="first"
Link: http://www.w3.org/ns/ldp/Resource;rel="type"
Accept-Patch: application/sparql-update
Body:
<http://localhost:8080/rest/path/to/resource>
a <http://fedora.info/definitions/v4/rest-api#resource> , <http://fedora.info/definitions/v4/rest-api#object> ,
<http://www.w3.org/ns/ldp#Container> , <http://www.w3.org/ns/ldp#Page> ;
<http://fedora.info/definitions/v4/repository#uuid>
"e8baa85c-f05a-49e8-9578-9adef92ac60d"^^<http://www.w3.org/2001/XMLSchema#string> ;
<http://www.w3.org/ns/ldp#inlinedResource>
<http://localhost:8080/rest/path/to> ;
<http://www.w3.org/ns/ldp#membersInlined>
"true" ;
<http://www.w3.org/ns/ldp#pageOf>
<http://localhost:8080/rest/path/to/resource> .
<http://fedora.info/definitions/v4/rest-api#exportsAs>
<http://localhost:8080/rest/path/to/resource/fcr:export?format=jcr/xml> ;
<http://fedora.info/definitions/v4/rest-api#hasVersions>
<http://localhost:8080/rest/path/to/resource/fcr:versions> ;
<http://fedora.info/definitions/v4/repository#created>
"2013-11-15T23:31:07.275Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
<http://fedora.info/definitions/v4/repository#createdBy>
"bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
<http://fedora.info/definitions/v4/repository#hasParent>
<http://localhost:8080/rest/path/to> ;
<http://fedora.info/definitions/v4/repository#lastModified>
"2013-11-15T23:31:07.268Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ; |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||||
---|---|---|---|---|---|---|
|
...
Create a new node at the given path, and recursively create any missing parent elements.
Query Parameters:
...
Example (1):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/some/path/to/a/new/resource" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/path/to/a/new/resource |
Example (2):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/some/path/to/a/new/resource?mixin=fedora:datastream" # Create a fedora:datastream |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
If the given resource path exists, a POST to that path will create a new node as a child of the given resource using a generated identifier.
Request Headers:
Status | ||||
---|---|---|---|---|
|
Note |
---|
The slug you provide does not guarantee the location of the created node. Clients must check the Location header for the path to the created resource. For full control over the generated path, see POST Create a new node at the given path (link me!) |
Query Parameters:
...
Example (1):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/this/node/already/exists" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/this/node/already/exists/some/generated/identifier |
Example (2):
Code Block |
---|
curl -X POST -H "Slug: new-node-name" "http://localhost:8080/rest/this/node/already/exists" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/this/node/already/exists/new/node/name |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
In addition to creating a new node, add the given properties to the object
Note |
---|
An RDF payload can be combined with any of the above forms. |
Note |
---|
RDF will be interpreted using the current resource as the base URI (e.g. <> will be expanded to the current URI) |
Query Parameters:
...
Example:
Code Block |
---|
curl -X POST -H "Content-Type: text/turtle" "http://localhost:8080/rest/node/to/create" -d "@body.rdf"
Request Body:
<> dc:title "some-resource-title"
|
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/node/to/create |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
In addition to creating a new node, execute a SPARQL-Update query against the newly created node.
Query Parameters:
...
Note |
---|
RDF will be interpreted using the current resource as the base URI (e.g. <> will be expanded to the current URI) |
Example:
Code Block |
---|
curl -X POST -H "Content-Type: application/sparql-update" "http://localhost:8080/rest/node/to/create" -d "@body.rdf"
Request Body:
INSERT {
<> dc:title "some-resource-title" .
}
WHERE { }
|
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/node/to/create |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
Note |
---|
If the binary content is RDF or a SPARQL-Update query, see Binary Content for an alternative way to create content |
Query Parameters:
...
Example (1):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/binary/resource/to/create" -d "@picture.jpg" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/binary/resource/to/create/fcr:content |
Example (2):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/binary/resource/to/create?checksum=urn:sha1:cb1a576f22e8e3e110611b616e3e2f5ce9bdb941" -d "@picture.jpg" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/binary/resource/to/create/fcr:content |
Example (3):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/binary/resource/to/create?checksum=urn:sha1:checksumdoesntmatch" -d "@picture.jpg" |
Response:
Code Block |
---|
Status: 409 Conflict
Error:
Checksum Mismatch of cb1a576f22e8e3e110611b616e3e2f5ce9bdb941 and urn:sha1:checksumdoesntmatch |
Note |
---|
By convention, binary content is accessed using the REST endpoint path/to/resource/fcr:content. |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
Modify the triples associated with the resource Status colour Yellow title PUT
Replace the existing triples for a resource with the triples provided in the request body.
Note |
---|
Some resource properties are repository managed and cannot be removed or modified. Any attempt to do so may result in a 4xx error. |
Note |
---|
RDF will be interpreted using the current resource as the base URI (e.g. <> will be expanded to the current URI) |
Request Headers:
...
Query Parameters:
...
Example:
Code Block |
---|
curl -X POST -H "Content-Type: text/turtle" "http://localhost:8080/rest/node/to/update" -d "@new-triples.rdf"
Request Body:
<> dc:title "some-resource-title" .
|
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
with SPARQL-Update Status colour Green title PATCH
Request Headers:
...
Example:
Code Block |
---|
curl -X PATCH -H "Content-Type: application/sparql-update" "http://localhost:8080/rest/node/to/update" -d "@body.rdf"
Request Body:
INSERT {
<> dc:title "some-resource-title" .
}
WHERE { }
|
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
Delete a resource Status colour Red title DELETE
Example:
Code Block |
---|
curl -X DELETE "http://localhost:8080/rest/node/to/delete" |
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
Move a resource (and its subtree) to a new location Status subtle true colour Red title MOVE
Example (1):
Code Block |
---|
curl -X MOVE -H "Destination: http://localhost:8080/rest/new/path/to/node" "http://localhost:8080/rest/path/to/node" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/new/path/to/node |
Example (2):
Code Block |
---|
curl -X MOVE -H "Destination: http://duraspace.org/some/path" "http://localhost:8080/rest/path/to/node" |
Response:
Code Block |
---|
Status: 502 Bad Gateway |
Status:
...
Status | ||||||
---|---|---|---|---|---|---|
|
...
Copy a resource (and its subtree) to a new location Status subtle true colour Blue title COPY
Example:
Code Block |
---|
curl -X COPY -H "Destination: http://localhost:8080/rest/new/path/to/node" "http://localhost:8080/rest/path/to/node" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/new/path/to/node |
Status:
...
Status | ||||||
---|---|---|---|---|---|---|
|
...
Binary Content
Request URI: /path/to/some/resource/fcr:content
Methods: GET, PUT, POST
Retrieve binary content Status title GET
Request Headers:
Status | ||||
---|---|---|---|---|
|
...
Status | ||||
---|---|---|---|---|
|
Example (1):
Code Block |
---|
curl "http://localhost:8080/rest/path/to/some/resource/fcr:content" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
ETag: "urn:sha1:cb1a576f22e8e3e110611b616e3e2f5ce9bdb941"
Content-Type: image/jpeg
Content-Length: 123456
Cache-Control: no-transform, must-revalidate, max-age=0
Last-Modified-At: 2013-01-01T01:23:45Z
Link: http://localhost:8080/rest/path/to/some/resource;rel="meta"
Accept-Ranges: bytes
Body:
<binary content> |
Example (2):
Code Block |
---|
curl -H "Range: bytes=1-5" "http://localhost:8080/rest/path/to/some/resource/fcr:content" |
Response:
Code Block |
---|
Status: 206 Partial Content
Headers:
ETag: "urn:sha1:cb1a576f22e8e3e110611b616e3e2f5ce9bdb941"
Content-Type: image/jpeg
Content-Range: bytes 1-5/9106
Content-Length: 5
Cache-Control:
Last-Modified-At: 2013-01-01T01:23:45Z
Link: http://localhost:8080/rest/path/to/some/resource;rel="meta"
Accept-Ranges: bytes
Body:
<binary content> |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||||
---|---|---|---|---|---|---|
|
...
...
Request Headers:
...
Query Parameters:
...
Example (1):
Code Block |
---|
curl -X POST -d "@image.jpg" "http://localhost:8080/rest/path/to/new/resource/fcr:content"
Body:
<binary content> |
Response (1):
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/path/to/new/resource/fcr:content |
Example (2):
Code Block |
---|
curl -X POST -d "@image.jpg" -H "Content-Disposition: inline; filename=\"image.jpg\"" "http://localhost:8080/rest/path/to/new/resource/fcr:content"
Body:
<binary content> |
Response (2):
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/path/to/new/resource/fcr:content |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
Replace existing binary content Status colour Yellow title PUT
Request Headers:
...
Query Parameters:
...
Example:
Code Block |
---|
curl -X POST -d "@image.jpg" "http://localhost:8080/rest/path/to/some/existing/resource/fcr:content"
Body:
<binary content> |
Response:
Code Block |
---|
Status: 204 No Content |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
Batch Operations
Request URI: /path/to/some/resource/fcr:datastreams
Methods: GET, POST, DELETE
Retrieve multiple binary resources in a single request Status title GET
Info |
---|
An HTTP method returning multipart/form-data is non-standard and a little unusual, but it seems to work well enough. |
Query Parameters:
...
Example:
Code Block |
---|
curl "http://localhost:8080/rest/path/to/some/resource/fcr:datastreams?dsid=content&dsid=thumbnail" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
ETag: "686897696a7c876b7e"
Content-Type: multipart/form-data; boundary=AaB03x
Content-Length: 123456
Cache-Control:
Last-Modified-At: 2013-01-01T01:23:45Z
Body:
--AaB03x
Content-Disposition: attachment; filename="content"
Content-Type: image/tiff
<binary content>
--AaB03x
Content-Disposition: attachment; filename="thumbnail"
Content-Type: image/jpeg
<binary content> |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||||
---|---|---|---|---|---|---|
|
...
Query Parameters:
Status | ||||
---|---|---|---|---|
|
Example:
Code Block |
---|
# creates the ds1 resource and removes the old-content resource
curl -X POST -F "ds1=@image.png" "http://localhost:8080/rest/path/to/some/resource/fcr:datastreams?delete=old-content" |
Response:
Code Block |
---|
Status: 201 Created |
Status:
...
Delete multiple resources in a single request Status colour Red title DELETE
Query Parameters:
...
Example:
Code Block |
---|
# removes both old-content and backup-content resources
curl -X DELETE "http://localhost:8080/rest/path/to/some/resource/fcr:datastreams?dsid=old-content&dsid=backup-content" |
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
Export / Import
Request URI: /path/to/some/resource
Methods: GET, POST
Note | ||
---|---|---|
Objects are exported and imported relative to the request URI path given. E.g., if you run:
The resource will be imported to http://localhost:8080/rest/somewhere/else/resource. |
fcr:export Retrieve serialized form of a resource and its subtree. Status title GET
Request Headers:
...
Note | ||
---|---|---|
The available export formats for an object are available as properties of nodes, e.g. this node exports jcr/xml:
|
Example:
Code Block |
---|
curl "http://localhost:8080/rest/path/to/some/resource/fcr:export" |
Response:
Code Block |
---|
Status: 200
Headers:
Content-Type: application/xml
Body:
<?xml version="1.0" encoding="UTF-8"?><sv:node xmlns:dc="http://purl.org/dc/terms/" xmlns:nt="http://www.jcp.org/jcr/nt/1.0" xmlns:ns001="http://purl.org/dc/elements/1.1/" xmlns:foaf="http://xmlns.com/foaf/0.1/" xmlns:test="info:fedora/test/" xmlns:image="http://www.modeshape.org/images/1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:fedorarelsext="http://fedora.info/definitions/v4/rels-ext#" xmlns:mix="http://www.... |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||||
---|---|---|---|---|---|---|
|
...
Request Headers:
...
Example:
Code Block |
---|
curl -X POST -d "@export.xml" "http://localhost:8080/rest/path/to/some/fcr:import?format=jcr/xml"
Body:
<?xml version="1.0" encoding="UTF-8"?><sv:node xmlns:dc="http://purl.org/dc/terms/" xmlns:nt="http://www.jcp.org/jcr/nt/1.0" xmlns:ns001="http://purl.org/dc/elements/1.1/" xmlns:foaf="http://xmlns.com/foaf/0.1/" xmlns:test="info:fedora/test/" xmlns:image="http://www.modeshape.org/images/1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:fedorarelsext="http://fedora.info/definitions/v4/rels-ext#" xmlns:mix="http://www.... |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/path/to/some/resource/ |
Status:
...
Status | ||||||
---|---|---|---|---|---|---|
|
Versioning
Request URI: /path/to/some/resource/fcr:versions
Methods: GET, POST
Warning |
---|
Versioning is not fully implemented in Fedora 4 alpha |
Get a list of the available versions of an object Status title GET
Get a previous version of an object Status title GET
...
Services
Backup and Restore
Request URI: /
Methods: GET, POST
...
Info |
---|
The backup will be stored in a temporary directory on the server. As yet, there is not a REST API method for retrieving the content of the backup. |
Example:
Code Block |
---|
curl -X POST "http://localhost:8080/rest/fcr:backup" |
Response:
Code Block |
---|
Status: 200 OK
Body:
/tmp/fcrepo4-data/path/to/backup/directory |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
Info |
---|
Does this overwrite existing data? Merge data with the backup? |
Example:
Code Block |
---|
curl -X POST -d "@backup.xml" "http://localhost:8080/rest/fcr:restore"
Body:
<binary content> |
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
Identifiers
Request URI: /path/to/some/resource/fcr:identifier
Methods: GET, POST
...
Request Headers:
Status | ||||
---|---|---|---|---|
|
Query Parameters:
...
Example (1):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/fcr:identifier" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/turtle
Body:
<http://localhost:8080/rest/fcr:identifier> <http://fedora.info/definitions/v4/repository#hasMember> <<http://localhost:8080/rest/newly-minted-identifier> |
Example (2):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/fcr:identifier?count=3" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/turtle
Body:
<http://localhost:8080/rest/fcr:identifier> <http://fedora.info/definitions/v4/repository#hasMember> <http://localhost:8080/rest/newly-minted-identifier><http://localhost:8080/rest/fcr:identifier> <http://fedora.info/definitions/v4/repository#hasMember> <http://localhost:8080/rest/another-newly-minted-identifier><http://localhost:8080/rest/fcr:identifier> <http://fedora.info/definitions/v4/repository#hasMember> <http://localhost:8080/rest/yet-another-minted-identifier> |
Example (3):
Code Block |
---|
curl -X POST "http://localhost:8080/rest/path/to/some/resource/fcr:identifier" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/turtle
Body:
<http://localhost:8080/rest/path/to/some/resource/fcr:identifier> <http://fedora.info/definitions/v4/repository#hasMember> <http://localhost:8080/rest/path/to/some/resource/newly-minted-identifier> |
Status:
...
Transactions
Request URI: /fcr:tx; /path/to/transaction/fcr:tx
Methods: POST
Get the current status of a transaction (TODO?) Status title GET
...
Info |
---|
After retrieving a transaction resource, the client can execute any REST API method prefixed by the transaction location. |
Warning |
---|
Transactions are automatically closed and rolled back after 3 minutes of inactivity. Transactions can be refreshed by POSTing to /rest/{tx:id}/fcr:tx |
Example:
Code Block |
---|
curl -X POST "http://localhost:8080/rest/fcr:tx" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/tx:83e34464-144e-43d9-af13-b3464a1fb9b5
Expires: Sat, 16 Nov 2013 00:32:57 GMT |
Usage:
Code Block |
---|
curl -X POST "http://localhost:8080/rest/tx:83e34464-144e-43d9-af13-b3464a1fb9b5/path/to/object/to/create"
curl -X DELETE "http://localhost:8080/rest/tx:83e34464-144e-43d9-af13-b3464a1fb9b5/path/to/resource/to/delete"
curl -X POST "http://localhost:8080/rest/tx:83e34464-144e-43d9-af13-b3464a1fb9b5/fcr:tx/fcr:commit |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
(roughly corresponding to Fedora 3 datastreams)
Containers
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Export and Import
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Versioning
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Services
Access Roles
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Backup and Restore
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Fixity
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Node Types
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Transactions
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Transform
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Example:
Code Block |
---|
curl -X POST "http://localhost:8080/rest/tx:123456789/fcr:tx/fcr:commit" |
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
...
Example:
Code Block |
---|
curl -X POST "http://localhost:8080/rest/tx:123456789/fcr:tx/fcr:rollback" |
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
Fixity
Request URI: /path/to/some/resource/fcr:fixity
Methods: GET
Get the fixity report for an object Status title GET
Note |
---|
Checking fixity requires retrieving the content from the binary store and may take some time. In the event of fixity corruption, in some cases, this will be automatically repaired. See Self-healing storage (link me!) |
Request Headers:
Status | ||||
---|---|---|---|---|
|
Example:
Code Block |
---|
curl -H "Accept: text/turtle" "http://localhost:8080/rest/path/to/some/binary/resource/fcr:fixity" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/turtle
Body:
<http://localhost:8080/rest/path/to/some/binary/resource>
a <http://fedora.info/definitions/v4/rest-api#resource> , <http://fedora.info/definitions/v4/rest-api#datastream> ;
<http://fedora.info/definitions/v4/repository#hasFixityResult>
[ <http://fedora.info/definitions/v4/repository#computedChecksum>
<urn:sha1:5441456941dd8b3ee0832b991ee93ba0c0a558f7> ;
<http://fedora.info/definitions/v4/repository#computedSize>
"471019"^^<http://www.w3.org/2001/XMLSchema#long> ;
<http://fedora.info/definitions/v4/repository#hasLocation> </org.infinispan.loaders.file.FileCacheStore:FedoraRepositoryBinaryData:org.infinispan.loaders.file.FileCacheStore:/var/folders/v3/wl82s37145b6jydsh9y5n8l40000gp/T//fcrepo4-data/fcrepo.ispn.binary.CacheDirPath> ;
<http://fedora.info/definitions/v4/repository#isFixityResultOf>
<http://localhost:8080/rest/path/to/some/binary/resource> ;
<http://fedora.info/definitions/v4/repository#status>
"SUCCESS"
] . |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||||
---|---|---|---|---|---|---|
|
Workspaces
Request URI: /fcr:workspaces/(workspace name)
Methods: POST, DELETE
...
Example:
Code Block |
---|
curl -X POST "http://localhost:8080/rest/fcr:workspaces/abc" # create a new workspace called "abc" |
Response:
Code Block |
---|
Status: 201 Created
Headers:
Location: http://localhost:8080/rest/workspace:abc |
Usage:
After creating a workspace, you can execute other REST API methods by prefixing the workspace identifier to requests
Code Block |
---|
curl -X POST "http://localhost:8080/rest/fcr:workspaces/abc"
curl -X POST "http://localhost:8080/rest/workspace:abc/path/to/some/new/resource |
Status:
...
...
Example:
Code Block |
---|
curl -X DELETE "http://localhost:8080/rest/fcr:workspaces/abc" # delete a new workspace called "abc" |
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
Content Modeling
Request URI: /fcr:nodetypes
Methods: GET, POST
Node types
get a list of registered types (as RDFS triples) Status title GET
Request Headers:
Status | ||||
---|---|---|---|---|
|
Example:
Code Block |
---|
curl "http://localhost:8080/rest/fcr:nodetypes" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/turtle
Body:
<http://fedora.info/definitions/v4/rest-api#object>
a <http://www.w3.org/2000/01/rdf-schema#Class> ;
<http://www.w3.org/2000/01/rdf-schema#label>
"fedora:object" ;
<http://www.w3.org/2000/01/rdf-schema#subClassOf>
<http://fedora.info/definitions/v4/rest-api#resource> .
<http://fedora.info/definitions/v4/rest-api#resource>
a <http://www.w3.org/2000/01/rdf-schema#Class> ;
<http://www.w3.org/2000/01/rdf-schema#label>
"fedora:resource" ;
<http://www.w3.org/2000/01/rdf-schema#subClassOf>
<http://fedora.info/definitions/v4/rest-api#relations> , <http://www.jcp.org/jcr/mix/1.0created> , <http://www.jcp.org/jcr/mix/1.0lastModified> , <http://www.jcp.org/jcr/mix/1.0lockable> , <http://www.jcp.org/jcr/mix/1.0versionable> .
[...]
|
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
Warning |
---|
The request body format for updating nodetypes is in flux. For now, and in the immediate future, it uses JCR's CND syntax , but we'd prefer a provider-independent format. |
Example:
Code Block |
---|
curl -X POST -H "Content-Type: text/cnd" -d "@cnd.txt" "http://localhost:8080/rest/fcr:nodetypes"
Body:
[fedora:custom_node_type] > fedora:resource mixin
- fedora:thumbnail (string)
|
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
Namespaces
Request URI: /fcr:namespaces
Methods: GET, POST
get a list of registered namespaces and default prefixes Status title GET
Request Headers:
Status | ||||
---|---|---|---|---|
|
Example:
Code Block |
---|
curl "http://localhost:8080/rest/fcr:namespaces" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/turtle
Body:
@prefix dc: <http://purl.org/dc/terms/> .
@prefix nt: <http://www.jcp.org/jcr/nt/1.0> .
@prefix fcrepo: <http://fedora.info/definitions/v4/repository#> .
dc: a <http://purl.org/vocommons/voaf#Vocabulary> ;
<http://purl.org/vocab/vann/preferredNamespacePrefix>
"dc" ;
<http://purl.org/vocab/vann/preferredNamespaceUri>
"http://purl.org/dc/terms/" .
fcrepo: a <http://purl.org/vocommons/voaf#Vocabulary> ;
<http://purl.org/vocab/vann/preferredNamespacePrefix>
"fcrepo" ;
<http://purl.org/vocab/vann/preferredNamespaceUri>
"http://www.jcp.org/jcr/1.0" .
nt: a <http://purl.org/vocommons/voaf#Vocabulary> ;
<http://purl.org/vocab/vann/preferredNamespacePrefix>
"nt" ;
<http://purl.org/vocab/vann/preferredNamespaceUri>
"http://www.jcp.org/jcr/nt/1.0" .
[....] |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
...
Info |
---|
There are some restrictions on what can be modified. (TODO: what are the caveats?) |
Example:
Code Block |
---|
curl -X POST -H "Content-Type: application/sparql-update" -d "@namespaces.rdf" "http://localhost:8080/rest/fcr:namespaces"
Body:
# Register the namespace 'info:some-namespace' with the prefix 'some'
INSERT {
<info:some-namespace> <http://purl.org/vocab/vann/preferredNamespacePrefix> "some"
} WHERE {
} |
Response:
Code Block |
---|
Status: 204 No Content |
Status:
...
Sitemaps
Request URI: /sitemap
Methods: GET, POST
get an XML Sitemap of content in the repository Status title GET
Example (1):
Code Block |
---|
curl "http://localhost:8080/rest/sitemap" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/xml
Body:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><sitemap:sitemapindex xmlns:sitemap="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap:sitemap><sitemap:loc>http://localhost:8080/rest/sitemap/1</sitemap:loc><sitemap:lastmod>2013-11-15T16:51:38.132-08:00</sitemap:lastmod><sitemap:changefreq>monthly</sitemap:changefreq><sitemap:priority>0.8</sitemap:priority></sitemap:sitemap></sitemap:sitemapindex> |
Example (2):
Code Block |
---|
curl "http://localhost:8080/rest/sitemap/1" |
Response:
Code Block |
---|
Status: 200 OK
Headers:
Content-Type: text/xml
Body:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><sitemap:urlset xmlns:sitemap="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap:url><sitemap:loc>http://localhost:8080/rest/00/cf/42/b8/00cf42b8-3a11-4af0-8972-48be8d9db5cd</sitemap:loc><sitemap:lastmod>2013-11-15T16:52:32.418-08:00</sitemap:lastmod><sitemap:changefreq>monthly</sitemap:changefreq><sitemap:priority>0.8</sitemap:priority></sitemap:url></sitemap:urlset> |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
Search
Properties text
Request URI: /fcr:search
Methods: GET
HTML form for submitting SPARQL queries Status title GET
Request Headers:
Status | ||||
---|---|---|---|---|
|
execute a fulltext search over indexed properties in the repository Status title GET
Query Parameters:
...
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Request Headers:
Status | ||||
---|---|---|---|---|
|
Example:
Code Block |
---|
curl -H "Accept: text/turtle" "http://localhost:8080/rest/fcr:search?q=bypassAdmin" |
Response:
Code Block |
---|
Status: 200
Headers:
Link: http://localhost:8080/rest/fcr:search?q=bypassAdmin&offset=0&limit=25;rel="first"
Content-Type: text/turtle
Body:
<http://localhost:8080/rest/fcr:search?q=bypassAdmin>
a <http://www.w3.org/ns/ldp#Page> , <http://sindice.com/vocab/search#Page> ;
<http://fedora.info/definitions/v4/repository#hasMember>
<http://localhost:8080/rest/00/cf/42/b8/00cf42b8-3a11-4af0-8972-48be8d9db5cd> ;
<http://fedora.info/definitions/v4/rest-api#hasMoreResults>
false ;
<http://sindice.com/vocab/search#itemsPerPage>
"25"^^<http://www.w3.org/2001/XMLSchema#int> ;
<http://sindice.com/vocab/search#searchTerms>
"bypassAdmin" ;
<http://sindice.com/vocab/search#startIndex>
"0"^^<http://www.w3.org/2001/XMLSchema#long> ;
<http://sindice.com/vocab/search#totalResults>
"1"^^<http://www.w3.org/2001/XMLSchema#long> ;
<http://www.w3.org/ns/ldp#firstPage>
<http://localhost:8080/rest/fcr:search?q=bypassAdmin&offset=0&limit=25> ;
<http://www.w3.org/ns/ldp#nextPage>
()
;
<http://www.w3.org/ns/ldp#pageOf>
<http://localhost:8080/rest/fcr:search?q=bypassAdmin> .
<http://localhost:8080/rest/00/cf/42/b8/00cf42b8-3a11-4af0-8972-48be8d9db5cd>
a <http://fedora.info/definitions/v4/rest-api#object> , <http://fedora.info/definitions/v4/rest-api#resource> ;
<http://fedora.info/definitions/v4/repository#created>
"2013-11-16T00:52:32.432Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
<http://fedora.info/definitions/v4/repository#createdBy>
"bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
<http://fedora.info/definitions/v4/repository#lastModified>
"2013-11-16T00:52:32.418Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
<http://fedora.info/definitions/v4/repository#lastModifiedBy>
"bypassAdmin"^^<http://www.w3.org/2001/XMLSchema#string> ;
<http://fedora.info/definitions/v4/repository#uuid>
"b9fb7c68-c5c8-4ecd-a1b6-5ffeeeb2ba3d"^^<http://www.w3.org/2001/XMLSchema#string> ; |
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||||
---|---|---|---|---|---|---|
|
SPARQL
Request URI: /fcr:sparql
Methods: GET
Warning |
---|
SPARQL query functionality is experimental and is not yet in any fcrepo4 release. |
HTML form for submitting SPARQL queries Status title GET
Request Headers:
Status | ||||
---|---|---|---|---|
|
...
Example:
Code Block |
---|
curl -H "Content-Type: application/sparql-query" -d @sparqlQuery.txt -H "Accept: " "http://localhost:8080/rest/fcr:sparql"
Body:
SELECT ?subject FROM <> WHERE { ?subject dc:title ?title } |
Response:
Code Block |
---|
Status: 200
Headers:
Content-Type: text/turtle
Body:
|
Status:
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||||
---|---|---|---|---|---|---|
|