getMediaGalleries

This methods return private galleries for logged user.

Authentication

This method doesn not require authentication.

Arguments

Argument Type Valid Values Default Value Detail
api_key string Valid Values required you need a valid api key to use the API
id Int existing media id required Search by media id
language_id Int
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
 2
  • French
  • English US
  • English UK
  • German
  • Spanish
  • Italian
  • Portuguese PT
  • Portuguese BR
thumbnail_size Int
  • 30
  • 110
  • 400
 110
  • Small (30px)
  • Medium (110px)
  • Large (400px - watermarked)

Returned Values

Element (path) Name Type Description
/[n]/ id int gallery unique ID
/[n]/ name string gallery name
/[n]/ nb_media int gallery media number
/[n]/ thumbnail_url string gallery thumbnail url
/[n]/ thumbnail_html_tag string gallery thumbnail html tag
/[n]/ thumbnail_width int gallery thumbnail width (px)
/[n]/ thumbnail_height int gallery thumbnail height(px)

Example Query


<?xml version="1.0" encoding="utf-8"?>
<methodCall>
	<methodName>xmlrpc.getMediaGalleries</methodName>
	<params>
		<param>
			<value>
				<string>YOUR_API_KEY</string>
			</value>
		</param>
		<param>
			<value>
				<int>20</int>
			</value>
		</param>
	</params>
</methodCall>

Example Response


<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <array>
          <data>
            <value>
              <struct>
                <member>
                  <name>nb_media</name>
                  <value>
                    <string>66</string>
                  </value>
                </member>
                <member>
                  <name>id</name>
                  <value>
                    <string>VzKgswYp1hXBvPTJdYIfi8lrs7OSlMo6</string>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string/>
                  </value>
                </member>
                <member>
                  <name>thumbnail_html_tag</name>
                  <value>
                    <string><img src="http://static-p2.fotolia.com/jpg/00/00/14/15/110_F_141537_h6K8IjXLmEgzHiWJlZ0fyGiVxkYUn6.jpg" alt="frog" title="frog" width="110" height="73" /></string>
                  </value>
                </member>
                <member>
                  <name>thumbnail_url</name>
                  <value>
                    <string>http://static-p2.fotolia.com/jpg/00/00/14/15/110_F_141537_h6K8IjXLmEgzHiWJlZ0fyGiVxkYUn6.jpg</string>
                  </value>
                </member>
                <member>
                  <name>thumbnail_width</name>
                  <value>
                    <int>110</int>
                  </value>
                </member>
                <member>
                  <name>thumbnail_height</name>
                  <value>
                    <double>73</double>
                  </value>
                </member>
              </struct>
            </value>
          </data>
        </array>
      </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.
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.
2001: Invalid Language ID
The language ID passed is not valid or doesn't exist in the fotolia available language list.
2101: Invalid Thumbnail Size
The thumbnail size passed is not valid or doesn't exist in the fotolia available thumbnail size list.