Difference between revisions of "Work.upload.lookup"

From Safe Creative API
Jump to navigation Jump to search
m (11 revisions imported)
(No difference)

Latest revision as of 08:07, 7 May 2021

Returns an upload URL and upload ID.

To upload a work you must use work.upload.begin, work.upload.chunk and work.upload.commit or upload the file by POST to an API upload servlet. These components are not available through the standard API endpoint (http://api.safecreative.org) but through dedicated upload servers. Before calling any of these components, you must call work.upload.lookup to get an upload server and id.


  • Component name: work.upload.lookup
  • Signature: Requires signature using the authkey's private key
  • Timestamp: Requires ztime parameter
  • Authorization level: ADD
  • API trust level: Standard


* Required parameter


  • workuploadlookup
    • uploadurl: Upload URL
      • If bypost is true, uploadurl is the direct URL to an API upload servlet which will handle the HTTP POST upload
      • If bypost is false, uploadurl is the base URL of the upload API server (you will need to add /v2/ to the URL when calling components)
    • uploadid: Upload ID, must be used as a parameter in the rest of upload components





<?xml version="1.0" encoding="UTF-8"?>

REQUEST (bypost):


RESPONSE (bypost):

<?xml version="1.0" encoding="UTF-8"?>