Clé API

Pour pouvoir utiliser l'API Fotolia, vous devez disposer d'une clé API. Cette clé API est indispensable pour pouvoir effectuer des requêtes à travers l'API. Vous pouvez obtenir une clé API en vous rendant dans la section "Outils" de votre espace personel et en complétant le formulaire API. Trois types de clés API sont disponibles : la clé API Partenaire, la clé API Business et la clé API développeur. En fonction de la clé API dont vous disposerez, certaines méthodes peuvent ne pas être disponibles. Prenez quelques instants pour étudier le tableau ci-dessous afin de vérifier quelles méthodes vous seront accessibles. Il est possible d'avoir plusieurs clés API. Chaque application créée doit être associée à une clé API différente.

Conditions Générales d'Utilisation de l'API

Les Conditions Générales d'Utilisation de l'API déterminent les droits et les conditions dans lesquelles chaque API peut être utilisée. Nous vous remercions de prendre connaissance des Conditions Générales d'Utilisation de l'API concernant l'API appropriée avant de l'utiliser.

Code

L'API Fotolia nécessite que toutes les données soient encodées en UTF-8. Plus d'informations sur l'UTF-8

Authentication

Certaines méthodes nécessitent une authentification (voir le tableau ci-dessous). L'authentification n'est disponible que pour l'API développeur et l'API Business. La processus d'authentification est comparable à la procédure d'identification sur le site Fotolia (Login). Les Logins et Mots de Passe doivent être envoyés de manière sécurisée grâce à l'API et, lorsqu'ils sont identifiés, un ID de session est attribué. Cet ID de session sera ensuite nécessaire pour utiliser les méthodes avec authentification. Pour plus d'informations sur l'authentification, veuillez consulter la méthode loginUser.

Méthodes

Les méthodes permettent d'exécuter différentes fonctionnalités à travers l'API. La tableau suivant indique les méthodes disponibles pour chaque type d'API. Les autre méthodes seront ajoutées prochainement.

Méthodes	API Partenaire	API Business	API Développeur	API Reseller	Authentication	Description
Recherche
getSearchResults					non	Pleine capacité de recherche
getCategories1					non	Renvoie les catégories représentatives
getCategories2					non	Renvoie les catégories conceptuelles
getTags					non	Renvoie le nuage de tags
getGalleries					non	Renvoie les galeries publiques
getColors					non	Renvoie le tableau des couleurs
getCountries					non	renvoie la liste des pays
Media
getMediaData					non	Renvoie toutes les informations sur un média
getMediaGalleries					non	Renvoie les galeries relatives au média
getMedia					oui	Renvoie le lien de téléchargement (média acheté)
getMediaComp					non	Renvoie l'URL de l'image maquette
Utilisateur
loginUser					non	Identifier un utilisateur (nécessaire pour l'authentification)
logoutUser					oui	Déconnecter un utilisateur (fermer la session)
getUserData					oui	Renvoie les informations sur l'utilisateur identifié
getUserStats					oui	Renvoie les statistiques du compte de l'utilisateur identifié
getUserGalleries					oui	Renvoie les galeries de l'utilisateur identifié
getUserGalleryMedias					oui	Renvoie les images de la lightbox/galerie d'un utilisateur identifié
deleteUserGallery					oui	Supprimer une galerie d'un utilisateur identifié
createUserGallery					oui	Créer une nouvelle galerie pour un utilisateur identifié
addToUserGallery					oui	Ajouter un fichier à une galerie d'un utilisateur identifié
removeFromUserGallery					oui	Retirer un fichier d'une galerie d'un utilisateur identifié
getUserAdvancedStats					oui	Renvoyer les statistiques avancées du compte d'un utilisateur identifié
Général
getData					non	Renvoie les informations générales à propos de Fotolia
test					non	renvoie "success"
API Reseller
user.subaccount.getIds					non	Retourne la liste des sous comptes
user.subaccount.create					non	Création d'un sous compte
user.subaccount.delete					non	Supression d'un sous compte
user.subaccount.edit					non	Modification d'un sous compte
user.subaccount.get					non	Récupération des informations d'un sous compte
user.subaccount.getPurchasedContents					non	Retourne la liste des achats effectués par un sous compte
media.getLicense					non	Retourne le contrat de licence entre le sous compte et le vendeur

Format des requêtes

XML/RPC

Le format XML/RPC est valable pour les requêtes et les réponses. Le XML-RPC est un protocole (Remote Procedure Calling) fonctionnant sur Internet. Un message XML-RPC est une requête HTTP-POST. Le corps de la requête (Body) est en XML. Une procédure s'execute sur le serveur et la valeur qu'il renvoie est également formatée en XML. Plus d'informations sur le XML/RPC

En-tête

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

Exemple de requête

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

Exemple de réponse

<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>test</name>
            <value>
              <string>Success</string>
            </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>

Kits API

Vous pouvez utiliser un kit qui vous aidera à simplifier votre utilisation de l'API. Voici la liste des kits disponibles. Si vous souhaitez proposer votre kit, n'hésitez pas à nous contacter, nous serons heureux de pointer vers votre site.

PHP

Ruby