download-marking

Methods

System

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.

Parameter (*=required)

Possible values

Default value

Description

id_media *

[string]
Sample: "2345"

lang

[string] single value

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

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

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>

Generally

System

Auth

Media

User (Generally)

User (Buyer)

User (Contributor)