Work.download.private: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Mpolo
(Changed work.download return)
m (6 revisions imported)
 
(2 intermediate revisions by one other user not shown)
Line 4: Line 4:
* '''Component name:''' work.download.private
* '''Component name:''' work.download.private
* '''Signature:''' Requires signature using the authkey's private key
* '''Signature:''' Requires signature using the authkey's private key
* '''Timestamp:''' ZTime is not required
* '''Timestamp:''' Requires ztime parameter
* '''Authorization level:''' GET
* '''Authorization level:''' GET
* '''API trust level''': Standard
* '''API trust level''': Standard
Line 10: Line 10:
= Parameters =  
= Parameters =  
* '''authkey*:''' Authorization key of the work owner
* '''authkey*:''' Authorization key of the work owner
* '''ztime*:''' Z-Timestamp
* '''code*:''' Work code
* '''code*:''' Work code



Latest revision as of 08:07, 7 May 2021

Returns the download URL for a user's work. The returned URL is only valid for a limited time.

Info

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

Parameters

  • authkey*: Authorization key of the work owner
  • ztime*: Z-Timestamp
  • code*: Work code

* Required parameter

Returns

  • url: Download URL

Example

REQUEST:

https://api.safecreative.org/v2/
?component=work.download.private
&authkey=Bb7NTK14QGeHjluE3vziqQ
&code=1003030120266
&ztime=1271749826106
&signature=06797af03767a19fef5acae915ff2b11bdad5535

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<downloadinfo>
  <url>[...]</url>
  <mimetype>[...]</mimetype>
</downloadinfo>