Clés 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 le menu "Mon compte" > "API" 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.
Quota de requêtes API
Par défaut, Fotolia limite le nombre de requêtes API à 500 par heure et à 10 000 par jour. Si vous estimez que votre trafic sera supérieur à ces plafonds, merci de contacter notre Service Client.
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. D'autres méthodes sont ajoutées régulièrement.
| 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 | ||
| getCategories2 | |
|
|
|
Non | Renvoie les concepts | ||
| 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 | ||
| Média | ||||||||
| 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é | ||
| user.moveUpMediaInUserGallery | |
|
|
|
yes | move up a media in an user galleryr | ||
| user.moveDownMediaInUserGallery | |
|
|
|
yes | move down a media in an user gallery | ||
| user.moveMediaToTopInUserGallery | |
|
|
|
yes | move a media to top position in an user gallery | ||
| getUserAdvancedStats | |
|
|
|
Oui | Renvoyer les statistiques avancées du compte d'un utilisateur identifié | ||
| Panier | ||||||||
| shoppingcart.getList | |
|
|
|
Oui | Renvoyer le contenu du panier utilisateur | ||
| shoppingcart.add | |
|
|
|
Oui | Ajouter un média au panier de l'utilisateur | ||
| shoppingcart.update | |
|
|
|
Oui | Modifier un média dans le panier de l'utilisateur | ||
| shoppingcart.remove | |
|
|
|
Oui | Supprimer un média du panier de l'utilisateur | ||
| shoppingcart.transferToLightbox | |
|
|
|
Oui | Supprimer un média du panier de l'utilisateur et l'ajouter à sa lightbox | ||
| shoppingcart.clear | |
|
|
|
Oui | Vider le panier utilisateur | ||
| Général | ||||||||
| getData | |
|
|
|
Non | Renvoie les informations générales à propos de Fotolia | ||
| test | |
|
|
|
Non | Renvoie "success" | ||
| API Reseller | ||||||||
| user.subaccount.getIds | |
|
|
|
Non | Renvoie 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 | Renvoie la liste des achats effectués par un sous-compte | ||
| media.getLicense | |
|
|
|
no | Renvoie le contrat de licence entre le revendeur et son client | ||
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.
