Der API Key

Um die Fotolia API zu verwenden und Anfragen an das Fotolia Database senden zu können, benötigt man eine Zugangsberechtigung in Form eines API Keys. Diesen API Key erhalten Sie in der Sektion "Tools" des Mitgliedsbereiches, nachdem Ihr Antragsformular überprüft und bewilligt wurde. Die API Schnittstelle steht in drei Versionen mit unterschiedlichen Funktionen zur Verfügung: die Partner API, die Developer API und die Business API. Die unten stehende Tabelle illustriert die Funktionen dieser drei API Versionen. Es ist möglich mehrere API Keys zu erhalten, doch bedarf jede Anwendung eines eigenen API Keys.

Nutzungsbedingungen

In den Nutzungsbedingungen der API sind die Vertragsbedingungen für den Einsatz der Fotolia API festgelegt. Bitte informieren Sie sich über die API Nutzungbedingungen der jeweiligen API, bevor Sie die API verwenden.

Kodierung

Die Fotolia API verschlüsselt Daten im UTF-8 Format. Weitere Information über UTF-8 Kodierung

Authentifizierung

Einige Funktionen der Developer und der Business API bedürfen der Authentifizierung. Diese sind in der unten stehenden Tabelle aufgelistet. Der Authentifizierungsprozess entspricht der Anmeldeprozedur der Fotolia Seite. Hierbei werden Login und Passwort sicher durch die API Schnittstelle versandt und nach der Prüfung wird eine Session-ID übermittelt. Diese Session-ID dient zur Authentifizierung der API Methoden. Weitere Information zu diesem Thema finden Sie unter loginUser Methoden.

Methoden

Methoden führen die API Funktionen aus. Die folgende Tabelle informiert über die unterschiedlichen Methoden, die mit den drei API Typen verfügbar sind

Methoden Partner API Business API Developer API Reseller API Authentifizierung Beschreibung
Suche
getSearchResults Authorized Authorized Authorized Authorized no full search capabilities
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
Medien
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
Anwender
loginUser Prohibited Authorized Authorized Authorized no log a user (needed for authentification)
logoutUser Prohibited Authorized Authorized Authorized yes log out a user (kill session)
getUserData Prohibited Authorized Authorized Authorized yes return information about the logged user
getUserStats Prohibited Authorized Authorized Authorized yes return account statistics of the logged user
getUserGalleries Prohibited Authorized Authorized Authorized yes retun galleries of the logged user
getUserGalleryMedias Prohibited Authorized Authorized Authorized yes Liefert den Inhalt des Leuchtkastens bzw. der Galerie eines eingeloggten Users.
deleteUserGallery Prohibited Authorized Authorized Authorized yes Galerie eines eingeloggten Users löschen
createUserGallery Prohibited Authorized Authorized Authorized yes Galerie für einen eingeloggten User anlegen
addToUserGallery Prohibited Authorized Authorized Authorized yes Datei einer User-Galerie hinzufügen
removeFromUserGallery Prohibited Authorized Authorized Authorized yes Datei aus einer User-Galerie entfernen
getUserAdvancedStats Prohibited Authorized Authorized Authorized yes Erweiterte Statistik eines User abfragen
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
Allgemein
getData Authorized Authorized Authorized Authorized no retun general information about Fotolia
test Authorized Authorized Authorized Authorized no return success
API Reseller
user.subaccount.getIds Prohibited Prohibited Prohibited Authorized no Verfügbare Sub-Account-IDs auflisten
user.subaccount.create Prohibited Prohibited Prohibited Authorized no Sub-Account erstellen
user.subaccount.delete Prohibited Prohibited Prohibited Authorized no Sub-Account löschen
user.subaccount.edit Prohibited Prohibited Prohibited Authorized no Daten eines Sub-Accounts aktualisieren
user.subaccount.get Prohibited Prohibited Prohibited Authorized no Details eines Sub-Account anzeigen
user.subaccount.getPurchasedContents Prohibited Prohibited Prohibited Authorized no Verkäufe eines Sub-Accounts auflisten
media.getLicense Prohibited Prohibited Prohibited Authorized no Lizenz (Reseller/Kunde) eines bestimmten Verkaufs anzeigen

Abfrageformat

XML/RPC

Für die Datenabfrage und -antwort wird das XML/RPC Format verwendet. XML-RPC (Extensible Markup Language Remote Procedure Call) ist eine Definition zum Methoden- und Funktionsabruf, die Netzwerke über das Internet verbindet. Die Darstellung der übertragenen Daten geschieht in der Extensible Markup Language (XML), während der Transport der Daten per Hypertext Transfer Protocol (HTTP) funktioniert. Sie fragen die Fotolia Datenbank also über XML ab und bekommen die Antwort bzw. Datei dann im HTTP Protokoll. Weitere Informationen über 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. Hier die Liste der verfügbaren API Kits. Wenn Sie Ihr eigenes Kit anbieten wollen, dann kontaktieren Sie uns bitte, und wir legen einen Link zu Ihrer Seite.

PHP

Ruby