Method: 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
