+49 (0)30 208 96 208

31.110.406 lizenzfreie Fotos,
Videos und Vektoren.

Wie arbeitet die Fotolia API?

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 Authorized Authorized Authorized Authorized nein alle Suchfunktionen
getCategories1 Authorized Authorized Authorized Authorized nein Anzeige der Repräsentativen Kategorien
getCategories2 Authorized Authorized Authorized Authorized nein Anzeige der Konzeptionellen Kategorien
getTags Authorized Authorized Authorized Authorized nein Anzeige der Schlagwortliste
getGalleries Authorized Authorized Authorized Authorized nein Anzeige öffentlicher Galerien
getSeasonalGalleries Authorized Authorized Authorized Authorized nein Anzeige saisonaler Galerien
getCountries Authorized Authorized Authorized Authorized nein Übersicht der Länder
Medien
getMediaData Authorized Authorized Authorized Authorized nein Anzeige aller Datei-Informationen
getBulkMediaData Authorized Authorized Authorized Authorized nein Anzeige aller Datei-Informationen über eine oder mehrere Dateien
getMediaGalleries Authorized Authorized Authorized Authorized nein Anzeige aller Galerien, die mit der Datei verknüpft sind
getMedia Prohibited Authorized Prohibited Authorized ja Ausgabe des Download-Links (Kauf)
getMediaComp Authorized Authorized Authorized Authorized nein Anzeige der URL des Layout-Bildes
getHomePageImages Authorized Authorized Authorized Authorized nein Anzeige der Bild-Details
Benutzer
loginUser Authorized Authorized Authorized Authorized nein Login des Nutzers
refreshToken Authorized Authorized Authorized Authorized nein Erneuern Sie Ihre Token ID
userSignUp Authorized Authorized Authorized Authorized nein Registrierung eines neuen Fotolia Mitgliedskontos
userEditProfile Authorized Authorized Authorized Authorized ja Bearbeiten eines Fotolia Mitgliedskontos
getUserData Authorized Authorized Authorized Authorized ja Anzeige der Benutzerdaten
getSalesData Authorized Authorized Authorized Authorized ja Anzeige der Verkaufszahlen des Mitglieds
getUserStats Authorized Authorized Authorized Authorized ja Anzeige der Statistik des Mitglieds
getUserGalleries Authorized Authorized Authorized Authorized ja Anzeige der Galerien des Mitglieds
getUserGalleryMedias Authorized Authorized Authorized Authorized ja Anzeige des Leuchtkastens / Galerien des Mitglieds
deleteUserGallery Authorized Authorized Authorized Authorized ja Löschen einer Galerie des Mitglieds
createUserGallery Authorized Authorized Authorized Authorized ja Erstellen einer neuen Galerie für das Mitglied
addToUserGallery Authorized Authorized Authorized Authorized ja Hinzufügen von Inhalten zu einer Galerie
removeFromUserGallery Authorized Authorized Authorized Authorized ja Löschen von Inhalten einer Galerie
user.moveUpMediaInUserGallery Authorized Authorized Authorized Authorized ja Inhalte einer Galerie nach oben verschieben
user.moveDownMediaInUserGallery Authorized Authorized Authorized Authorized ja Inhalte einer Galerie nach unten verschieben
user.moveMediaToTopInUserGallery Authorized Authorized Authorized Authorized ja Inhalte einer Galerie ganz nach oben verschieben
getUserAdvancedStats Authorized Authorized Authorized Authorized ja Anzeige von Statistiken zu einem Konto
getLastOnlineContents Authorized Authorized Authorized Authorized ja Anzeige der zuletzt angenommenen Dateien eines Benutzers
getUploadFolders Authorized Authorized Authorized Authorized ja Anzeige des letzten Upload-Ordners eines registrierten Anbieters
getUploadFolderFileIds Authorized Authorized Authorized Authorized ja Anzeige der Bildnummern innerhalb eines Upload-Ordners
uploadIdCard Authorized Authorized Authorized Authorized ja Hochladen eines neuen Personalausweises eines Anbieters
upload Authorized Authorized Authorized Authorized ja Hochladen einer neuen Datei in ein Nutzerkonto
getLastUploadedMedia Authorized Authorized Authorized Authorized ja Anzeige der Uploads der letzten 7 Tage
Einkaufswagen
shoppingcart.getList Prohibited Authorized Prohibited Authorized ja Anzeige des Einkaufswagens
shoppingcart.add Prohibited Authorized Prohibited Authorized ja Hinzufügen einer Datei in den Einkaufswagen
shoppingcart.update Prohibited Authorized Prohibited Authorized ja Aktualisieren einer Datei im Einkaufswagen
shoppingcart.remove Prohibited Authorized Prohibited Authorized ja Entfernen einer Datei aus dem Einkaufswagen
shoppingcart.transferToLightbox Prohibited Authorized Prohibited Authorized ja Eine Datei aus dem Einkaufswagen in den Leuchtkasten verschieben
shoppingcart.clear Prohibited Authorized Prohibited Authorized ja Alle Dateien im Einkaufswagen löschen
Hauptteil
getData Authorized Authorized Authorized Authorized nein Anzeige von Informationen über Fotolia
test Authorized Authorized Authorized Authorized nein Anzeige "Success"
Reseller API
user.subaccount.getIds Prohibited Prohibited Prohibited Authorized nein Anzeige aller Subaccounts
user.subaccount.create Prohibited Prohibited Prohibited Authorized nein Einen neuen Subaccount erstellen
user.subaccount.delete Prohibited Prohibited Prohibited Authorized nein Einen Subaccount löschen
user.subaccount.edit Prohibited Prohibited Prohibited Authorized nein Die Profildaten eines Subaccounts bearbeiten
user.subaccount.get Prohibited Prohibited Prohibited Authorized nein Anzeige der Subaccount-Details
user.subaccount.getPurchasedContents Prohibited Prohibited Prohibited Authorized nein Anzeige der Käufe durch Subaccounts
media.getLicense Prohibited Prohibited Prohibited Authorized 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.

PHP, Java and Python