Work.download: Difference between revisions
Jump to navigation
Jump to search
w>Mpolo m Changed work.download return |
w>Jguillo No edit summary |
||
| Line 1: | Line 1: | ||
Partner component to get the download URL for any work. The returned URL is only valid for a limited time. | Partner component to get the download URL for any work. The returned URL is only valid for a limited time. | ||
Work must | Work must allow downloads or evaluation. | ||
You must be a Safe Creative partner to use this component. | You must be a Safe Creative partner to use this component. | ||
| Line 22: | Line 22: | ||
* '''url''': Download URL | * '''url''': Download URL | ||
* '''mimetype''': Mime Type | * '''mimetype''': Mime Type | ||
* '''type''': | |||
** '''ORIGINAL''': The download URL is for the original work | |||
** '''EVALUATION''': The download URL is for an evaluation version of the work | |||
= Example = | = Example = | ||
Revision as of 13:26, 9 February 2011
Partner component to get the download URL for any work. The returned URL is only valid for a limited time.
Work must allow downloads or evaluation.
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
- type:
- ORIGINAL: The download URL is for the original work
- EVALUATION: The download URL is for an evaluation version of the work
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>