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	Authentifizierung	Beschreibung
Suche
getSearchResults				no	full search capabilities
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
Medien
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
Anwender
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	Liefert den Inhalt des Leuchtkastens bzw. der Galerie eines eingeloggten Users.
deleteUserGallery				yes	Galerie eines eingeloggten Users löschen
createUserGallery				yes	Galerie für einen eingeloggten User anlegen
addToUserGallery				yes	Datei einer User-Galerie hinzufügen
removeFromUserGallery				yes	Datei aus einer User-Galerie entfernen
getUserAdvancedStats				yes	Erweiterte Statistik eines User abfragen
Allgemein
getData				no	retun general information about Fotolia
test				no	return success

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