Versions Compared

Version Old Version 1 New Version Current
Changes made by

Tom Jones

Megan Forbes

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...



The Blob Service offers a RESTful API to perform CRUD (create, read, update, and delete) operations on file/document related information. Included in this information is the type and encoding of a file, and a reference to the location of the actual file/document bits.

When possible, these operations follow the Common model for CollectionSpace REST services.

...

Code Block
Image Terms = {'thumbnail' = 64 x 64, 'small' = 128 x 128, 'medium' = 256 x 256 }
Wiki Markup
{multi-excerpt-include:pageTitle=Media Service RESTful API|name=current-derivative-terms|nopanel=true}


Info

As of the v1.7 release, only the following image-related derivative terms exist:

  • 'Thumbnail' (a JPEG-format derivative, 64 x 64 pixels)
  • 'Medium' (a JPEG-format derivative, 256 x 256 pixels)
  • 'OriginalJpeg' (a JPEG-format derivative, with the same pixel resolution as the original image)


Table of Contents

Table of Contents
maxLevel5
styledecimal

...

Code Block
POST to "/blobs" with MIME=multipart/form-data

Notes: Returns the csid of the blob record. The csid is part of the fully qualified URL that is returned in the location header of the HTTP response.

...

Code Block
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Strict//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
        <title>Blob Service POST Example</title>
    </head>
     <body>
        <h1>Blob Service POST Example</h1>
        <form method="POST" action="http://localhost:8180/cspace-services/blobs?blobUri="             enctype="multipart/form-data">
            <label>Please select a file to post to the Blob service:</label>
            <br />
            <input type="file" size="50" name="file" />
            <br />
            <input type="submit" value="Upload now!" />
        </form>
    </body>
</html>

...

post_blobUriYou can also use a tool like cURL to POST an image.  Here is an example:
curl -X POST http://localhost:8180/cspace-services/blobs -i -u admin@core.collectionspace.org:Administrator -F file=@myImage.jpg
 Code Block

2. Create new blob record - POST request contains no embedded document/file payload - Option #2
 Code Block
POST to "/blobs?blobUri=" with MIME=application/xml

Notes: Using the 'blobUri' query parameter, you can include a URI to a FILE resource or an HTTP resource that you want the service to use when creating the blob record. If the URI is set and valid, then the Blob service will try to use the URI to create a blob record as well as store and relate a copy of the document/file. The information in the blob record (see Blob Info Schema) is automatically populated by the Blob service and derived from the resource pointed to by the URI.
...
 Note
iconfalse
titleSupported URL protocols
  • If the 'blobUri' refers to an HTTP resource, the service assumes the resource is not protected -i.e., does not require authentication credentials.
  • If the 'blobUri' refers to a FILE resource, the file must exists on (or be reachable from) the same machine upon which the Blob service is running. It also means that the appropriate file-system permissions exist on the resource such that the service can access and read it.
 Code Block
# the blobUri references a file named "cow.jpg" located in the Apache Tomcat folder where the CollectionSpace server is running
POST to blobs?blobUri=file:cow.jpg
 
# the blobUri references a file using an absolute path located in the Tomcat folder where the CollectionSpace server is running
POST to blobs?blobUri=file:///Users/remillet/dev/temp/cow.jpg

Blob Service GET requests.
...
 Code Block
GET to "/blobs/{csid}"

Notes: Returns the blob record corresponding to the csid -see Blob Info Schema. If the blob record was created with a document/file then a URL to the blob's content (the document/file) is included in the resulting payload.
...
 Code Block
GET to "/blobs/{csid}/content"

Notes: If the blob record was created with a document/file then this returns the blob data content (a file/document) corresponding to the blob record's csid
...
 Code Block
GET to "/blobs/{csid}/content/metadata"

Notes: Returns the full set of raw metadata that exists for the content of the blob record with csid. This metatdata will essentially be a property bag specific to the media-type/MIME-type of the content.
...
 Code Block
GET to "/blobs/{csid}/derivatives"

Notes: Returns a list of blob derivatives corresponding to the blob record's csid. This will include a URL to each derivative.
...
 Code Block
GET to "/blobs/{csid}/derivatives/{derivative_term}"

Notes: Returns what is essentially a "blob record" for the specified blob derivative. Initially, the derivative term will be one of a small set of controlled terms -i.e., 'thumbnail', 'small', 'medium', etc. Derivative terms will be defined in a CollectionSpace configuration file.
...
 Code Block
GET to "/blobs/{csid}/derivatives/{derivative_term}/content"

Notes: Returns the data content of the derivative.
...
 Code Block
GET to "/blobs/{csid}/derivatives/{derivative_term}/content/metadata"

Notes: Returns the full set of raw metadata that exists for the derivative's content. Anchorbottombottom

Blob Service UPDATE requests:
...
 Code Block
PUT to "/blobs/{csid}" with MIME=multipart/form-data

Notes: Returns the csid of the blob record.
 Note
This PUT request to /blobs/{csid} is not currently implemented. Please see CSPACE-6633 for updates.
...
2. Update an existing blob record:
 Code Block
PUT to "/blobs/{csid}" with MIME=multipart/xml

Notes: The payload must include a 'srcUri' parameter that is set to a valid and accessible URI.