API upload servlet

From Safe Creative API
Revision as of 08:45, 14 May 2010 by w>Jguillo
Jump to navigation Jump to search

You can upload works using standard HTTP upload via POST multipart request.

The upload URL must be retrieved using work.upload.lookup

Info

HTTP request must be configured with header:

Content-Type: multipart/form-data

Parameters

  • uploadid*: Upload ID returned by work.upload.lookup.
    • Can be included in the POST body or as a querystring argument in the URL
  • file*: File contents as a file parameter in the POST body

Returns

The servlet returns an upload ticket (see work.upload.commit) directly (with no XML enclosure)

Example

REQUEST:

http://upload01.safecreative.org/api-upload
Content-Type: multipart/form-data; boundary=AaB03x

--AaB03x
Content-Disposition: form-data; name="uploadid"

3c33a96c-7743-43d0-9614-db70fa46d3ad
--AaB03x
Content-Disposition: file; name="file"; filename="file1.txt"
Content-Type: text/plain

These are the file contents
--AaB03x--

RESPONSE

HvWIbGj7anDefJK3tQHdPze8ekYaVUQJgKw_N6t0Wd_UblANNOjyVfkyK0fgPXRPgiR8SyVr7HmS4Uiiediu6MlFVYIcjUD0zc4Kc8m3e2Irr14iQi-A215pEaqlvOSZ6WUIbWvY-GD2e8akWxhESdnFG088_nUHEsAjkOvnF-ogK144M4vLuIj4Ylc6inW-80LNnqH10kh7zMJcxsv0lZzTMGrXa2pN