Work.download: Difference between revisions
Jump to navigation
Jump to search
w>Jguillo No edit summary |
m 16 revisions imported |
||
| (4 intermediate revisions by one other user not shown) | |||
| 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 allow | Work must allow download 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 9: | Line 9: | ||
* '''Signature:''' Requires signature using the shared key's private key | * '''Signature:''' Requires signature using the shared key's private key | ||
* '''Timestamp:''' Requires ztime parameter | * '''Timestamp:''' Requires ztime parameter | ||
* '''API trust level''': Partner | * '''API trust level''': Partner | ||
| Line 22: | Line 21: | ||
* '''url''': Download URL | * '''url''': Download URL | ||
* '''mimetype''': Mime Type | * '''mimetype''': Mime Type | ||
* '''type''': | * '''type''': What will be downloaded from the URL | ||
** '''ORIGINAL''': The | ** '''ORIGINAL''': The original work | ||
** '''EVALUATION''': | ** '''EVALUATION''': An evaluation version of the work | ||
= Example = | = Example = | ||
| Line 43: | Line 42: | ||
<url>[...]</url> | <url>[...]</url> | ||
<mimetype>[...]</mimetype> | <mimetype>[...]</mimetype> | ||
<type>ORIGINAL</type> | |||
</downloadinfo> | </downloadinfo> | ||
</pre> | </pre> | ||
[[Category:API component]] | [[Category:API component]] | ||
Latest revision as of 08:07, 7 May 2021
Partner component to get the download URL for any work. The returned URL is only valid for a limited time.
Work must allow download 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
- 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: What will be downloaded from the URL
- ORIGINAL: The original work
- EVALUATION: 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> <type>ORIGINAL</type> </downloadinfo>