API Key
Um unsere API nutzen zu können, benötigen Sie einen API Key. Der API Key ermöglicht den Datenaustausch durch die API. Zur Beantragung eines API Key klicken Sie bitte in der Menüleiste auf “API” und wählen den Button API Key anfordern. Anschließend füllen Sie das Antragsformular aus. Fotolia stellt drei unterschiedliche API Keys zur Verfügung: Partner API Key, Developer API Key, Business API Key, die sich in Ihrer Funktionalität unterscheiden. In der unten stehenden Übersicht finden Sie näheres dazu. Es ist möglich, mehrere API Keys bewilligt zu bekommen. Jede gewünschte Applikation muss mit einem eigenständigen API Key verbunden sein.
Nutzungsbedingungen
Die API Nutzungsbedingungen regeln die Rechte und Pflichten zur Verwendung jeder angebotenen API. Bitte lesen Sie vor der Nutzung die API Nutzungsbedingungen der entsprechenden API.
Codierung
Alle Daten Fotolia API erfordern UTF-8 Codierung. Mehr Info über UTF-8 Codierung
Authentifizierung
Einige Methoden erfordern eine Authentifizierung (siehe unten). Die Authentifizierung ist nur für die Developer und Business API vorgesehen. Der Prozess der Authentifizierung läuft ähnlich ab, wie der Login auf der Fotolia Webseite. Die Zugangsdaten müssen sicher an die API übertragen werden. Nach erfolgter Authentifizierung wird Ihnen eine Session ID zur Verfügung gestellt. Diese Session ID wird benötigt um Methoden zu nutzen die eine Authentifizierung erfordern. Für mehr Informationen zu Authentifizierung, beachten Sie bitte unsere Hinweise zu loginUser Methode.
API Call Quote
Die Anzahl der API Calls bei Fotolia ist automatisch auf 500 pro Stunde und 10000 pro Tag begrenzt.
Sollte Ihr erwarteter Traffic höher sein, kontaktieren Sie bitte unseren Support.
Methoden
Methoden machen es möglich, verschiedene Funktionen über die API auszuführen. Die folgende Übersicht stellt die verfügbaren Methoden jeder API dar. Weitere Methoden folgen in Kürze.
| Methoden | Partner API | Business API | Developer API | Reseller API | Authentifizierung | Beschreibung | ||
|---|---|---|---|---|---|---|---|---|
| Search | ||||||||
| Suchergebnisse |  |
|
|
|
no | alle Suchfunktionen | ||
| getCategories1 | |
|
|
|
no | return representative categories | ||
| getCategories2 | |
|
|
|
no | return conceptual categories | ||
| getTags | |
|
|
|
no | return tag cloud | ||
| getGalleries | |
|
|
|
no | return public galleries | ||
| getColors | |
|
|
|
no | return color scheme | ||
| getCountries | |
|
|
|
no | return countries list | ||
| Media | ||||||||
| getMediaData | |
|
|
|
no | return all information about a media | ||
| getMediaGalleries | |
|
|
|
no | return galleries attached to a media | ||
| getMedia | |
|
|
|
yes | return download link (media purchase) | ||
| getMediaComp | |
|
|
|
no | return url of the comp image | ||
| User | ||||||||
| loginUser | |
|
|
|
no | log a user (needed for authentification) | ||
| logoutUser | |
|
|
|
yes | log out a user (kill session) | ||
| getUserData | |
|
|
|
yes | return information about the logged user | ||
| getUserStats | |
|
|
|
yes | return account statistics of the logged user | ||
| getUserGalleries | |
|
|
|
yes | retun galleries of the logged user | ||
| getUserGalleryMedias | |
|
|
|
yes | return the lightbox/gallery content of a logged user | ||
| deleteUserGallery | |
|
|
|
yes | Delete a gallery from the logged user | ||
| createUserGallery | |
|
|
|
yes | create a new gallery for the logged user | ||
| addToUserGallery | |
|
|
|
yes | add a content to a gallery of the logged user | ||
| removeFromUserGallery | |
|
|
|
yes | remove a content from a galley of the logged user | ||
| 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 | |
|
|
|
yes | return advanced account statistics of the logged user | ||
| Shopping cart | ||||||||
| shoppingcart.getList | |
|
|
|
yes | Returns shopping cart content | ||
| shoppingcart.add | |
|
|
|
yes | Add a media to the user's shopping cart | ||
| shoppingcart.update | |
|
|
|
yes | Update a media into the user's shopping cart | ||
| shoppingcart.remove | |
|
|
|
yes | Remove a media from the user's shopping cart | ||
| shoppingcart.transferToLightbox | |
|
|
|
yes | Remove a media from the user's shopping cart and add to to his lightbox | ||
| shoppingcart.clear | |
|
|
|
yes | Clear the user's shopping cart | ||
| Main | ||||||||
| getData | |
|
|
|
no | retun general information about Fotolia | ||
| test | |
|
|
|
no | return success | ||
| Reseller API | ||||||||
| user.subaccount.getIds | |
|
|
|
no | Returns an array of all available subaccount IDs | ||
| user.subaccount.create | |
|
|
|
no | Create a reseller subaccount | ||
| user.subaccount.delete | |
|
|
|
no | Delete a reseller subaccount | ||
| user.subaccount.edit | |
|
|
|
no | Update data of a reseller subaccount | ||
| user.subaccount.get | |
|
|
|
no | Get reseller subaccount details | ||
| user.subaccount.getPurchasedContents | |
|
|
|
no | Get the list of purchases made by a subaccount | ||
| media.getLicense | |
|
|
|
no | Get the licence between the reseller and his customer for a specific sale. | ||
Abfrage Format
XML/RPC
XML/RPC Format wird für Datenabfragen- und Antworten verwendet. XML-RPC ist ein Remote Procedure Calling Protocol, das Netzwerke über das Internet verbindet. Eine XML-RPC Message ist eine HTTP-POST Abfrage. Der Hauptteil der Abfrage ist in XML. Sie fragen die Datenbank also in XML ab und erhalten einen in ebenfalls XML formatierten Wert zurück. Mehr Informationen zu XML/RPC
Header
POST /Xmlrpc/rpc HTTP/1.0
Host: api.fotolia.com
Connection: close
Content-Type: text/xml
Content-Length: 569
Abfragebeispiel
<?xml version="1.0" encoding="utf-8"?>
<methodCall>
<methodName>xmlrpc.test</methodName>
<params>
<param>
<value>
<string>YOUR_API_KEY</string>
</value>
</param>
</params>
</methodCall>
Antwortbeispiel
<?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>
API Kits
Mit einem API Kit vereinfachen Sie den Umgang mit der Fotolia API. Anbei finden Sie eine Liste der verfügbaren Kits. Bitte kontaktieren Sie uns, falls Sie Ihr eigenes Kit anbieten wollen, so dass wir eine Verlinkung zu Ihrer Seite vornehmen können.
