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
Ältere XML-RPC API
Wir empfehlen Ihnen Ihre XML-RPC API auf die neue REST API umzustellen, da diese API nicht mehr aktualisiert wird. Sie können weiterhin auf die Dokumentation unter Dokumentation zugreifen.
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 | ||
|---|---|---|---|---|---|---|---|---|
| Suche | ||||||||
| getSearchResults |  |
|
|
|
nein | alle Suchfunktionen | ||
| getCategories1 | |
|
|
|
nein | Anzeige der Repräsentativen Kategorien | ||
| getCategories2 | |
|
|
|
nein | Anzeige der Konzeptionellen Kategorien | ||
| getTags | |
|
|
|
nein | Anzeige der Schlagwortliste | ||
| getGalleries | |
|
|
|
nein | Anzeige öffentlicher Galerien | ||
| getSeasonalGalleries | |
|
|
|
nein | Anzeige saisonaler Galerien | ||
| getCountries | |
|
|
|
nein | Übersicht der Länder | ||
| Medien | ||||||||
| getMediaData | |
|
|
|
nein | Anzeige aller Datei-Informationen | ||
| getBulkMediaData | |
|
|
|
nein | Anzeige aller Datei-Informationen über eine oder mehrere Dateien | ||
| getMediaGalleries | |
|
|
|
nein | Anzeige aller Galerien, die mit der Datei verknüpft sind | ||
| getMedia | |
|
|
|
ja | Ausgabe des Download-Links (Kauf) | ||
| getMediaComp | |
|
|
|
nein | Anzeige der URL des Layout-Bildes | ||
| getHomePageImages | |
|
|
|
nein | Anzeige der Bild-Details | ||
| Benutzer | ||||||||
| loginUser | |
|
|
|
nein | Login des Nutzers | ||
| refreshToken | |
|
|
|
nein | Erneuern Sie Ihre Token ID | ||
| userSignUp | |
|
|
|
nein | Registrierung eines neuen Fotolia Mitgliedskontos | ||
| userEditProfile | |
|
|
|
ja | Bearbeiten eines Fotolia Mitgliedskontos | ||
| getUserData | |
|
|
|
ja | Anzeige der Benutzerdaten | ||
| getSalesData | |
|
|
|
ja | Anzeige der Verkaufszahlen des Mitglieds | ||
| getUserStats | |
|
|
|
ja | Anzeige der Statistik des Mitglieds | ||
| getUserGalleries | |
|
|
|
ja | Anzeige der Galerien des Mitglieds | ||
| getUserGalleryMedias | |
|
|
|
ja | Anzeige des Leuchtkastens / Galerien des Mitglieds | ||
| deleteUserGallery | |
|
|
|
ja | Löschen einer Galerie des Mitglieds | ||
| createUserGallery | |
|
|
|
ja | Erstellen einer neuen Galerie für das Mitglied | ||
| addToUserGallery | |
|
|
|
ja | Hinzufügen von Inhalten zu einer Galerie | ||
| removeFromUserGallery | |
|
|
|
ja | Löschen von Inhalten einer Galerie | ||
| user.moveUpMediaInUserGallery | |
|
|
|
ja | Inhalte einer Galerie nach oben verschieben | ||
| user.moveDownMediaInUserGallery | |
|
|
|
ja | Inhalte einer Galerie nach unten verschieben | ||
| user.moveMediaToTopInUserGallery | |
|
|
|
ja | Inhalte einer Galerie ganz nach oben verschieben | ||
| getUserAdvancedStats | |
|
|
|
ja | Anzeige von Statistiken zu einem Konto | ||
| getLastOnlineContents | |
|
|
|
ja | Anzeige der zuletzt angenommenen Dateien eines Benutzers | ||
| getUploadFolders | |
|
|
|
ja | Anzeige des letzten Upload-Ordners eines registrierten Anbieters | ||
| getUploadFolderFileIds | |
|
|
|
ja | Anzeige der Bildnummern innerhalb eines Upload-Ordners | ||
| uploadIdCard | |
|
|
|
ja | Hochladen eines neuen Personalausweises eines Anbieters | ||
| upload | |
|
|
|
ja | Hochladen einer neuen Datei in ein Nutzerkonto | ||
| getLastUploadedMedia | |
|
|
|
ja | Anzeige der Uploads der letzten 7 Tage | ||
| Einkaufswagen | ||||||||
| shoppingcart.getList | |
|
|
|
ja | Anzeige des Einkaufswagens | ||
| shoppingcart.add | |
|
|
|
ja | Hinzufügen einer Datei in den Einkaufswagen | ||
| shoppingcart.update | |
|
|
|
ja | Aktualisieren einer Datei im Einkaufswagen | ||
| shoppingcart.remove | |
|
|
|
ja | Entfernen einer Datei aus dem Einkaufswagen | ||
| shoppingcart.transferToLightbox | |
|
|
|
ja | Eine Datei aus dem Einkaufswagen in den Leuchtkasten verschieben | ||
| shoppingcart.clear | |
|
|
|
ja | Alle Dateien im Einkaufswagen löschen | ||
| Hauptteil | ||||||||
| getData | |
|
|
|
nein | Anzeige von Informationen über Fotolia | ||
| test | |
|
|
|
nein | Anzeige "Success" | ||
| Reseller API | ||||||||
| user.subaccount.getIds | |
|
|
|
nein | Anzeige aller Subaccounts | ||
| user.subaccount.create | |
|
|
|
nein | Einen neuen Subaccount erstellen | ||
| user.subaccount.delete | |
|
|
|
nein | Einen Subaccount löschen | ||
| user.subaccount.edit | |
|
|
|
nein | Die Profildaten eines Subaccounts bearbeiten | ||
| user.subaccount.get | |
|
|
|
nein | Anzeige der Subaccount-Details | ||
| user.subaccount.getPurchasedContents | |
|
|
|
nein | Anzeige der Käufe durch Subaccounts | ||
| media.getLicense | |
|
|
|
nein | Anzeige der Lizenz zwischen Kunde und Reseller für einen bestimmten Kauf. | ||
Query Format
HTTP
Die Fotolia API ist eine REST API, auf welche mit HTTP Standardabfragen zugegriffen werden kann. Diese verwendet die GET Methode für den Lesezugriff und die POST Methode für Registrierungen, Datenänderungen und Abfragen.
Weitere Informationen zu REST
Um die REST API zu verwenden, muss jede Abfrage mit dem API Key als HTTP Benutzername und entweder einem leeren String (für öffentliche Methoden) oder einem Session Token (für verschlüsselte Verbindungen) als Passwort gesendet werden.
Basis URL
Die REST AP ist über diesen Link: http://api.fotolia.com/Rest/1/ erreichbar
Ausgabe-Format
Die REST API arbeitet mit dem JSON Format, das von den gängigsten Programmiersprachen unterstützt wird.
Weitere Information zum JSON Format
Beispiel-Abfrage
In diesem Beispiel verwenden wir die Methode main/test mit dem Benutzernamen 'exampleApiKey' und kein Passwort. Die Identifizierung erfolgt über den Base64 codierten String "exampleApiKey".
GET /Rest/1/main/test HTTP/1.0
Host: api.fotolia.com
Authorization: Basic ZXhhbXBsZUFwaUtleTo=
Methoden, welche mit GET abgefragt werden, können auch direkt in Ihrem Browser über die URL http://exampleApiKey:@api.fotolia.com/Rest/1/main/test aufgerufen werden.
Beispiel-Antwort
{
"test":"Success"
}
API Kits
Sie können auch einen Kit verwenden, um die API Nutzung zu vereinfachen. Eine Liste von Kits finden Sie unterstehend aufgelistet. Wenn Sie möchten, dass Ihr Kit mit in die Liste aufgenommen wird, kontaktieren Sie uns.
