+49 (0)30 208 96 208

22.364.983 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

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 Authorized Authorized Authorized Authorized no alle Suchfunktionen
getCategories1 Authorized Authorized Authorized Authorized no return representative categories
getCategories2 Authorized Authorized Authorized Authorized no return conceptual categories
getTags Authorized Authorized Authorized Authorized no return tag cloud
getGalleries Authorized Authorized Authorized Authorized no return public galleries
getColors Authorized Authorized Authorized Authorized no return color scheme
getCountries Authorized Authorized Authorized Authorized no return countries list
Media
getMediaData Authorized Authorized Authorized Authorized no return all information about a media
getMediaGalleries Authorized Authorized Authorized Authorized no return galleries attached to a media
getMedia Prohibited Authorized Prohibited Authorized yes return download link (media purchase)
getMediaComp Authorized Authorized Authorized Authorized no return url of the comp image
User
loginUser Authorized Authorized Authorized Authorized no log a user (needed for authentification)
logoutUser Authorized Authorized Authorized Authorized yes log out a user (kill session)
getUserData Authorized Authorized Authorized Authorized yes return information about the logged user
getUserStats Authorized Authorized Authorized Authorized yes return account statistics of the logged user
getUserGalleries Authorized Authorized Authorized Authorized yes retun galleries of the logged user
getUserGalleryMedias Authorized Authorized Authorized Authorized yes return the lightbox/gallery content of a logged user
deleteUserGallery Authorized Authorized Authorized Authorized yes Delete a gallery from the logged user
createUserGallery Authorized Authorized Authorized Authorized yes create a new gallery for the logged user
addToUserGallery Authorized Authorized Authorized Authorized yes add a content to a gallery of the logged user
removeFromUserGallery Authorized Authorized Authorized Authorized yes remove a content from a galley of the logged user
user.moveUpMediaInUserGallery Authorized Authorized Authorized Authorized yes move up a media in an user galleryr
user.moveDownMediaInUserGallery Authorized Authorized Authorized Authorized yes move down a media in an user gallery
user.moveMediaToTopInUserGallery Authorized Authorized Authorized Authorized yes move a media to top position in an user gallery
getUserAdvancedStats Authorized Authorized Authorized Authorized yes return advanced account statistics of the logged user
Shopping cart
shoppingcart.getList Prohibited Authorized Prohibited Authorized yes Returns shopping cart content
shoppingcart.add Prohibited Authorized Prohibited Authorized yes Add a media to the user's shopping cart
shoppingcart.update Prohibited Authorized Prohibited Authorized yes Update a media into the user's shopping cart
shoppingcart.remove Prohibited Authorized Prohibited Authorized yes Remove a media from the user's shopping cart
shoppingcart.transferToLightbox Prohibited Authorized Prohibited Authorized yes Remove a media from the user's shopping cart and add to to his lightbox
shoppingcart.clear Prohibited Authorized Prohibited Authorized yes Clear the user's shopping cart
Main
getData Authorized Authorized Authorized Authorized no retun general information about Fotolia
test Authorized Authorized Authorized Authorized no return success
Reseller API
user.subaccount.getIds Prohibited Prohibited Prohibited Authorized no Returns an array of all available subaccount IDs
user.subaccount.create Prohibited Prohibited Prohibited Authorized no Create a reseller subaccount
user.subaccount.delete Prohibited Prohibited Prohibited Authorized no Delete a reseller subaccount
user.subaccount.edit Prohibited Prohibited Prohibited Authorized no Update data of a reseller subaccount
user.subaccount.get Prohibited Prohibited Prohibited Authorized no Get reseller subaccount details
user.subaccount.getPurchasedContents Prohibited Prohibited Prohibited Authorized no Get the list of purchases made by a subaccount
media.getLicense Prohibited Prohibited Prohibited Authorized 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.

PHP

Ruby