download-media

get/buy/redownload an media file

Requires a charged prepaid account or distribution partner account.
For prepaid accounts, each download is subtracted from the deposit of the specified account.
If there is no deposit on the account, a (get/buy) download is not possible anymore (Error code 402).
Distribution partners require as sales report account, need a special agreement. Please contact our sales team.

Creates a new licensing order, and starts the media delivery process.
To check the status of this process, use the returned "queue_hash". After the file is ready for download, this method returns a download URL.

Parameter

Parameter (*=required)	Possible values	Default value	Description
id_media *	[string] Sample: "2345"
id_article *	[string] comma separated Sample: "eur-56,eur-480" or "image-73821"		Please use method get-media-info (with parameter "show_articles=yes") to see all articles for this image. For subscription and packets you only use a single article id (i.e. "id_article=image-73821") For singlebuy (credits and real currency) you get several article ids (one for the size, another one for extended rights): Article id for size is obligatory. Article id for extended right is optional, if don't set the standard licence is sold. Both article ids (size and extended rights) are separated with comma, i.e. "id_article=eur-56,eur-480"
id_download	[integer]		redownload: This ID will be returnd by the answer or the method "get-downloaded-images" (content body or for content-type "application/octet-stream" by http headers) of the initial call. If you use the parameter id_download the parameter id_article get be void. Attention: Use it only for redownload of same purchase. Don't use it, if have a special contract account with "marking"!
queue_hash	[string]		status check: To check the status of the order process.
callback_url	[string]		When the order becomes "ready", a POST request will be sent to the given "callback_url" to notify you that the download is ready with the download status and download url.
lang	[string] single value da de en es it pl pt	en	language see also get-user-content-langs for getting all language values dynamically
metadata	[string] single value all (iptc and xmp) iptc (only for mimetype image/jpeg) xmp none	none	Information Interchange Model: type of metadata applied to the image file (IPTC, XMP, both or none). In IPTC or XMP metadata all kind of informations are stored, i.e. keywords, author, copyright etc.
mediainfo	[string] single value yes no	no	Adds the media information (<media/>, <metadata/> and <options>) from the get-media-info method on successful return. Attention: The data is returned only at the status "ready" in a manual request with the parameter "queue_hash". This parameter has no effect on the original purchase request and the data is not delivered via callback function.
test	[string] single value yes no	no	For free testing of download: If test=yes, the downloaded image has a watermark and no deposit is settled (nevertheless you see the info how much deposit would be settled) .

User-Authentication

optional (if you call this method without user auth, the method use the deposit from app account)

Endpoint

https://rest.panthermedia.net/download-media

Sample Request - buy media

POST https://rest.panthermedia.net/download-media Accept-Version: 1.0 Content-Type: application/x-www-form-urlencoded api_key=a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1g&access_key=9de82c2a78df66e615274eec2622b53795abb2dd&timestamp=Thu%2C%2002%20Aug%202012%2005%3A54%3A55%20UTC&nonce=123&algo=sha1&auth_token=c0c0b98897b5f72b965990b50adec67264a6f07b9134173e9ac60e6b73fe0474&access_token=da857e7ff0013b003185aee5cd41178bead62e46&id_media=813689&id_article=eur-56

Sample Request - check status

POST https://rest.panthermedia.net/download-media Accept-Version: 1.0 Content-Type: application/x-www-form-urlencoded api_key=a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1g&access_key=9de82c2a78df66e615274eec2622b53795abb2dd&timestamp=Thu%2C%2002%20Aug%202012%2005%3A54%3A55%20UTC&nonce=123&algo=sha1&auth_token=c0c0b98897b5f72b965990b50adec67264a6f07b9134173e9ac60e6b73fe0474&access_token=da857e7ff0013b003185aee5cd41178bead62e46&id_media=813689&queue_hash=0D704D6A-B1CE-C856-DA35-7DE4B4D34D78

Sample Request - redownload

Sample Error - not enough deposit

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <rsp stat="fail"> <err code="402" msg="Payment Required (not enough deposit left)" /> <buy_deposit_url><![CDATA[https://stockagency.panthermedia.net/cms/credits]]></buy_deposit_url> <internal><![CDATA[vcvNSlUfMt/tRi8db1NwkNbHe/pbj22P0XBK2bp0ZetytDwZCckR/19LjP/0jw1xUUeyMy6RCKNX+AO0TWqkprAoOfhMNlfI8XX7QgW6nOX4p18O6ZRWPbQidL7LIfKQT5S3ki0ctLma+F2wueyO2nNY5BqAGCpj5xgWdzuPAlUkzue8HVWvyY5yQ87/Nqi2EbAsmO0ulWC5cOPIL/8dwnvpZat62n0Xsq9MTDyVdlo6E2QvRGuR3TE/fLFGQAkpeHjpVVa5If6cn98nf9lv5SBzsq0PCmT8DM7dUu0fzmvm01spQna85ggNCFkP3L+PBsCxIJ10/f4n5rLn+PBYy5yh+TczugqwnNn1wPK/uPWwJBEzwsIA/DXVt+AdVWLxQbtpUHZJRYNsdNsrXnzqGUz7oujvTp72JxMRyLQnEqwYEg8g9PIKIHtlG1kLk9HSlQ9B6cnQDYaK/6J/4Wm2IscXs6JsqyOEwqEsadjAgAvj364WQb9O7QU467aGte7gKhU8awaYAykQuwX1nqCsrc0Z7Bt4wN45riZgIOM72Od1jq9LmAEK9vNV3dHLMBr1YQ9kLkKrvA1USjVEgoL0BA==]]></internal> </rsp>

Sample Error - download error


      <?xml version="1.0" encoding="UTF-8" standalone="yes"?>

      <rsp stat="fail">

            <err code="500" msg="unknown error, please contact PantherMedia" />

            <token>5d8a4a195c9eac24a519f1dde8a396654f557b27e323ec8d6651caa2dc7f9c54</token>

            <download_status>

                  <id_media>174846</id_media>

                  <id_download>174846</id_download>

                  <queue_hash>0D704D6A-B1CE-C856-DA35-7DE4B4D34D78</queue_hash>

                  <mimetype>image/jpeg</mimetype>

                  <status>error</status>

                  <download_url/>

            </download_status>

      </rsp>

Sample Answer - buy media


      <?xml version="1.0" encoding="UTF-8" standalone="yes"?>

      <rsp stat="ok">

            <token>5d8a4a195c9eac24a519f1dde8a396654f557b27e323ec8d6651caa2dc7f9c54</token>

            <download_infos>

                  <extended_rights>allext</extended_rights>

                  <deposit_settled>56</deposit_settled>

                  <deposit_currency>CREDITS</deposit_currency>

            </download_infos>

            <download_status>

                  <id_media>174846</id_media>

                  <id_download>7419514</id_download>

                  <queue_hash>0D704D6A-B1CE-C856-DA35-7DE4B4D34D78</queue_hash>

                  <mimetype>image/jpeg</mimetype>

                  <status>pending</status>

                  <download_url/>

            </download_status>

      </rsp>

Sample Answer - download ready


      <?xml version="1.0" encoding="UTF-8" standalone="yes"?>

      <rsp stat="ok">

            <token>5d8a4a195c9eac24a519f1dde8a396654f557b27e323ec8d6651caa2dc7f9c54</token>

            <download_status>

                  <id_media>174846</id_media>

                  <id_download>7419514</id_download>

                  <queue_hash>0D704D6A-B1CE-C856-DA35-7DE4B4D34D78</queue_hash>

                  <mimetype>image/jpeg</mimetype>

                  <status>ready</status>

                  <download_url>https://download.panthermedia.net/dlm.php?authcode=k6KGc3yTooZzfJOihnN8k6KGc3yTooZzhJeqi3aFlqWHeIOcqY16gZa</download_url>

            </download_status>

      </rsp>

Generally

System

Auth

Media

User (Generally)

User (Buyer)

User (Contributor)