getMedia

This method allows to purchase a media and returns url to the purchased file.

Authentication

This method requires authentification. This method is only available for Business API. You need to have a Fotolia Account with credits to be abble to download media.

Arguments

Argument Type Element (array) Valid Values Default Value Detail
api_key string Valid Values required you need a valid api key to use the API
session_id string existing session ID required authentified session ID( use loginUser to create a session ID)
id int existing media ID required Media ID (ID of the Media whose you want to purchase a license)
license_name string existing license name for this Media ID required Media license name

Returned Values

Element (path) Name Type Description
/ url string URL where you can download the purchased Media. This url must be kept hidden and is valid during 72 hours

Example Query


<?xml version="1.0" encoding="utf-8"?>
<methodCall>
	<methodName>xmlrpc.getMedia</methodName>
	<params>
		<param>
			<value>
				<string>bSvckxpOlCJSU4hLrMyJTnhBbXX3Jt</string>
			</value>
		</param>
		<param>
			<value>
				<string>SESSION_ID</string>
			</value>
		</param>
		<param>
			<value>
				<int>20</int>
			</value>
		</param>
		<param>
			<value>
				<string>M</string>
			</value>
		</param>
	</params>
</methodCall>

Example Response


<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>url</name>
            <value>
              <string>http://download.fotolia.com/DownloadContent/1/h7G0bWGsGof8VvSqw32xFZ0KvD5eqbvN</string>
            </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>

Error Codes

001: Service currently unavailable
The requested service is temporarily unavailable.
002: Failed to parse request
The XML-RPC request document could not be parsed.
010: Missing API Key
The API key passed is missing.
011: Invalid API Key
The API key passed is not valid or has expired.
020: Missing Session ID
The session ID passed is missing. A valid session ID is needed to access this method
021: Invalid Session ID
The session ID passed is not valid. Please login to get a valid session ID.
031: Invalid Method
This method does not exist in the method list.
032: Method not Available
This method is not available for this API Key.
100: Missing Media ID
The media ID is missing. Media ID is required for this method.
101: Invalid Media ID
The media ID passed is not valid or doesn't correspond to any media.
2200: Missing License Name
The License Name is needed to purchase a media.
2201: Invalid License Name
The License Name passed is not valid, doesn't exist or is not available for this media
3000: Insufficent Credit Value
You don't have enough money on your account to purchase media