[RESTful Web-service Documentation]
go top

download-marking

get an media file

This method only supports downloads with a special "sales report" contract and only for contributor "panthermedia". Please contact our sales team.

For regular purchases and downloads via credits, subscriptions and other options, please use the method download-media.

Parameter

Parameter (*=required)
Possible values
Default value
Description
id_media *
[string]
Sample: "2345"


lang
[string] single value
  • da
  • de
  • en
  • es
  • it
  • pl
  • pt

en
language

see also get-user-content-langs for getting all language values .
Is only needed in combination with the "mediainfo" parameter.
mediainfo
[string] single value
  • yes
  • no
no
Adds the media information (<media/>, <metadata/> and <options>) from the get-media-info method.

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-marking

Sample Request

POST https://rest.panthermedia.net/download-marking
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=2345

Sample Request - with mediainfo

POST https://rest.panthermedia.net/download-marking
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=2345&mediainfo=yes

Sample Answer

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
  <api_key>a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1g</api_key>
  <download_infos>
    <extended_rights/>
    <deposit_settled/>
    <deposit_currency>download</deposit_currency>
  </download_infos>
  <download_status>
    <id_media>2345</id_media>
    <id_download>7419514</id_download>
    <queue_hash/>
    <mimetype>image/jpeg</mimetype>
    <status>ready</status>
    <download_url>https://download.panthermedia.net/dlm.php?authcode=k6KGc3yTooZzfJOihnN8k6KGc3yTooZzhJeqi3aFlqWHeIOcqY16gZa</download_url>
  </download_status>
</rsp>

Sample Answer - with mediainfo

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
  <api_key>a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1g</api_key>
  <mediainfo>
    <media>
      <id>2345</id>
      <thumb_150_url><![CDATA[https://agency.panthermedia.net/media/previews/0000000000/00002000/00002345_thumb.jpg]]></thumb_150_url>
      <thumb_170_url><![CDATA[https://agency.panthermedia.net/media/previews/0000000000/00002000/00002345_thumb_170.jpg]]></thumb_170_url>
      <preview_url><![CDATA[https://agency.panthermedia.net/media/previews/0000000000/00002000/00002345_preview.jpg]]></preview_url>
      <preview_url_high><![CDATA[https://agency.panthermedia.net/media/previews/0000000000/00002000/00002345_high.jpg]]></preview_url_high>
      <width>3508px</width>
      <height>2339px</height>
      <mime_type>image/jpeg</mime_type>
    </media>
    <metadata>
      <keywords><![CDATA[tree, trees, field, tuscany, hill, fields, toscana, picturesque, hilly, mild, cypresses, unclouded, cloudless, scenery, countryside, nature, italy, clouds, blauer himmel, h├╝gellandschaft]]></keywords>
      <keywords_top10><![CDATA[tree, field, trees, tuscany, nature, tree, field, italy, clouds, scenery]]></keywords_top10>
      <title><![CDATA[toscana]]></title>
      <description><![CDATA[tree in toscana italy]]></description>
      <author_realname><![CDATA[Peter Chr. Ammel]]></author_realname>
      <author_username><![CDATA[petera]]></author_username>
      <model_id/>
      <model_release>no</model_release>
      <property_release>no</property_release>
      <editorial>no</editorial>
    </metadata>
    <options>
      <extended>yes</extended>
      <subscription>yes</subscription>
      <packet>yes</packet>
      <premium>no</premium>
      <adult_content>no</adult_content>
    </options>
  </mediainfo>
  <download_infos>
    <extended_rights/>
    <deposit_settled/>
    <deposit_currency>download</deposit_currency>
  </download_infos>
  <download_status>
    <id_media>364</id_media>
    <id_download>7419514</id_download>
    <queue_hash/>
    <mimetype>image/jpeg</mimetype>
    <status>ready</status>
    <download_url>https://download.panthermedia.net/dlm.php?authcode=k6KGc3yTooZzfJOihnN8k6KGc3yTooZzhJeqi3aFlqWHeIOcqY16gZa</download_url>
  </download_status>
</rsp>