Clave API

Para usar Fotolia API, necesita una clave API. La clave API es requerida para realizar cualquier consulta a través de API. Puede obtener una clave API en su sección "Herramientas" dentro de su cuenta y completando el formulario de solicitud API. Existen tres tipos de claves API disponibles: Clave Socios API, Clave API Desarrolladores, Clave API Negocios. Dependiendo del tipo de clave API que tenga, algunos métodos pueden no estar disponibles. Revise el cuadro seguido para verificar los métodos disponibles para usted. Es posible tener diversas claves API. Cada aplicación creada debe estar asociada a una diferente clave API.

Términos de Uso

Los Términos de Uso API determinan los derechos y condiciones en que cada API puede ser utilizada. Por favor revise el contrato de Términos de uso API para el API adecuado antes de utilizarlo.

Codificación

API Fotolia requiere que todos los datos estén codificados en UTF-8. Más información sobre codificación UTF-8.

Autentificación

Algunos métodos necesitan ser autentificados (ver tabla abajo). La autentificación está solamente disponible para API Negocios y Desarrolladores. El proceso de autentificación es equivalente al proceso de login en el website Fotolia. El login y contraseña deben ser enviados de modo seguro a través de API con la ID de sesión que será provista. Este ID de sesión será necesaria para usar métodos con autentificación. Para más información sobre autentificación, por favor vea login de usuario método.

Métodos

Hacen posible ejecutar diferentes acciones a través de API. La tabla siguiente da información sobre los métodos disponibles con cada tipo de API. Otros métodos serán añadidos pronto.

Métodos	API socios	API negocios	API desarrolladores	API Revendedor	Autentificación	Descripción
Buscar
getSearchResults					no	plenas capacidades de búsqueda
getCategories1					no	categorías representativas
getCategories2					no	categorías conceptuales
getTags					no	nube de tags
getGalleries					no	galerías públicas
getColors					no	patrón de color
getCountries					no	lista de países
Medios
getMediaData					no	devolver toda la información sobre los medios
getMediaGalleries					no	galerías adjuntas a los medios
getMedia					sí	enlace de descarga (compra de medios)
getMediaComp					no	enlace de la imagen borrador
Usuario
loginUser					no	identificar usuario (necesario para autentificación)
logoutUser					sí	salir usuario (cerrar sesión)
getUserData					sí	información sobre el usuario logueado
getUserStats					sí	estadísticas de cuenta del usuario logueado
getUserGalleries					sí	galerías del usuario logueado
getUserGalleryMedias					sí	Devuelve las Selecciones / Galería de contenido de un usuario registrado
deleteUserGallery					sí	borrar una galería del usuario
createUserGallery					sí	crear una nueva galería para el usuario
addToUserGallery					sí	añadir un contenido a una galería del usuario
removeFromUserGallery					sí	borrar un contenido de una galería del usuari
getUserAdvancedStats					sí	obtener estadísticas avanzadas de la cuenta del usuar
Principal
getData					no	volver a información general sobre Fotolia
API Reseller
user.subaccount.getIds					no	Devuelve selección de todos los ID de sub-cuentas disponibles
user.subaccount.create					no	Creación de sub-cuenta revendedor
user.subaccount.delete					no	Borrar sub-cuenta revendedor
user.subaccount.edit					no	Actualizar datos de sub-cuenta revendedor
user.subaccount.get					no	Obtener detalles de sub-cuenta revendedor
user.subaccount.getPurchasedContents					no	Obtener la lista de compras de sub-cuenta
media.getLicense					no	Obtener la licencia entre revendedor y su cliente para una venta concreta.

Formato de consultas

XML/RPC

El formato XML/RPC está disponible para consultas/respuestas. XML-RPC es un procedimiento de protocolo remoto que funciona en internet. Un mensaje XML-RPC es una petición HTTP-POST. El cuerpo está en XML. Un procedimiento ejecuta en el servidor y el valor devuelve también XML formateado. más información sobre XML/RPC

Cabecera

POST /Xmlrpc/rpc HTTP/1.0
Host: api.fotolia.com
Connection: close
Content-Type: text/xml
Content-Length: 569

Ejemplo de consulta

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

Ejemplo de respuesta

<?xml version="1.0" encoding="utf-8"?>
<methodCall>
  <methodName>fotolia.test.test</methodName>
  <params>
     <param>
       <value>
         <struct>
           <member>
                <name>name</name>
                <value><string>value</string></value>
           </member>
           <member>
                <name>name2</name>
                <value><string>value2</string></value>
           </member>
         </struct>
       </value>
     </param>
   </params>
</methodCall>

Kits API

Puede usar un kit para simplificar el modo en que usa API. Aquí está la lista de kits disponibles. Si desea proponer un kit, contáctenos y redireccionaremos a su sitio.

PHP

Ruby