Work.download: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Mpolo
m Changed work.download auth policy
w>Mpolo
mNo edit summary
Line 13: Line 13:


= Parameters =  
= Parameters =  
* '''authkey*:''' Authorization key
* '''sharedkey*:''' Your application shared key
* '''ztime*:''' Z-Timestamp
* '''code*:''' Work code
* '''code*:''' Work code



Revision as of 11:18, 16 September 2010

Partner component to get the download URL for any work. The returned URL is only valid for a limited time.

Work must be publicly registered and allow downloads.

This component must be accessed using an authkey from a partner application.

Info

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

Parameters

  • sharedkey*: Your application shared key
  • ztime*: Z-Timestamp
  • code*: Work code

* Required parameter

Returns

  • url: Download URL

Example

REQUEST:

https://api.safecreative.org/v2/
?component=work.download
&authkey=Bb7NTK14QGeHjluE3vziqQ
&code=1003030120266
&signature=0c941f02e79c1265b4799bebb1b184c4875da070

RESPONSE:

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