Work.download: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Mpolo
Changed work.download return
w>Mpolo
m Changed work.download return
Line 38: Line 38:
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<downloadinfo>
<downloadinfo>
<url>[...]</url>
  <url>[...]</url>
<mimetype>[...]</mimetype>
  <mimetype>[...]</mimetype>
</downloadinfo>
</downloadinfo>
</pre>
</pre>


[[Category:API component]]
[[Category:API component]]

Revision as of 11:36, 21 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.

You must be a Safe Creative partner to use this component.

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
  • mimetype: Mime Type

Example

REQUEST:

https://api.safecreative.org/v2/
?component=work.download
&sharedkey=zy9x4ol0ctg3btyswq7b5wi9
&code=1003030120266
&ztime=1271749826106
&signature=3b2d5552b5cd969c370ce70dae280a76dc844895

RESPONSE:

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