Klucz API

Aby korzystać z API, musisz posiadać klucz API. Klucz API jest potrzebny do tworzenia zapytań poprzez API. Możesz zdobyć klucz API, idąc do sekcji „Narzędzia” na Twoim koncie i uzupełniając formularz API. Dostępne są trzy rodzaje kluczy API: klucz Partner API, klucz Developer API i klucz Biznes API. W zależności od rodzaju klucza, który posiadasz, mogą wystąpić pewne ograniczenia w użyciu. Zobacz poniższą tabelę zawierającą informacje o dostępnych metodach wykorzystania. Można również posiadać kilka kluczy API. Każda stworzona aplikacja musi być połączona z innym kluczem API.

Zasady użytkowania

Zasady użytkowania API określają prawa i warunki, w jakich każdy API może zostać użyty. Prosimy zapoznać się z Zasady użytkowania API dla właściwego API przed użyciem.

Kodowanie

Fotolia API wymaga wszystkich danych w systemie kodowania UTF-8. Więcej informacji na temat kodowania UTF-8

Uwierzytelnienie

Niektóre metody wymagają uwierzytelenia (zobacz poniższą tabelę). Uwierzytelnienie jest dostępne tylko dla Developer i Biznes API. Proces uwierzytelnienia jest równoważny z procesem logowania do strony Fotolia. Login i hasło muszą być bezpiecznie wysłane poprzez API po uwierzytelnieniu ID sesji. ID sesji będzie niezbędne do używania sposobów z uwierzytelnieniem. Aby dowiedzieć się więcej na temat uwierzytelnienia, zobacz metodęloginUser metoda.

Metody

Metody pozwalają korzystać z różnych funkcji za pomocą API. Poniższa tabela zawiera informacje na temat metod dostępnych w ramach każdego typu API. Niebawem zostaną również dodane inne metody.

Metody Partner API Biznes API Developer API Reseller API Uwierzytelnienie Opis
Wyszukiwanie
getSearchResults Authorized Authorized Authorized Authorized nie pełna opcja szukania
getCategories1 Authorized Authorized Authorized Authorized nie powrót do kategorii reprezentatywnych
getCategories2 Authorized Authorized Authorized Authorized nie powrót do kategorii konceptualnych
getTags Authorized Authorized Authorized Authorized nie powrót do chmury znaczników
getGalleries Authorized Authorized Authorized Authorized nie powrót do galerii publicznych
getColors Authorized Authorized Authorized Authorized nie powrót do schematu koloru
getCountries Authorized Authorized Authorized Authorized nie powrót do listy krajów
Media
getMediaData Authorized Authorized Authorized Authorized nie powrót do wszystkich informacji o Mediach
getMediaGalleries Authorized Authorized Authorized Authorized nie powrót do galerii połączonych z mediami
getMedia Prohibited Authorized Prohibited Authorized tak powrót do pobrania linku (zakup mediów)
getMediaComp Authorized Authorized Authorized Authorized nie powrót do url prewki
Użytkownik
loginUser Prohibited Authorized Authorized Authorized nie zaloguj użytkownika (potrzebne do uwierzytelnienia)
logoutUser Prohibited Authorized Authorized Authorized tak wyloguj użytkownika (kill session)
getUserData Prohibited Authorized Authorized Authorized tak powrót do informacji o zalogowanym użytkowniku
getUserStats Prohibited Authorized Authorized Authorized tak powrót do konta statystyk zalogowanego użytkownika
getUserGalleries Prohibited Authorized Authorized Authorized tak powrót do galerii zalogowanego użytkownika
getUserGalleryMedias Prohibited Authorized Authorized Authorized tak powrót do lightboxu/galerii zalogowanego użytkownika
deleteUserGallery Prohibited Authorized Authorized Authorized tak Usuń galerię z zalogowanego użytkownika
createUserGallery Prohibited Authorized Authorized Authorized tak Utwórz nową galerię dla zalogowanego użytkownika
addToUserGallery Prohibited Authorized Authorized Authorized tak Dodaj plik do galerii zalogowanego użytkownika
removeFromUserGallery Prohibited Authorized Authorized Authorized tak Usuń plik z galerii zalogowanego użytkownika
getUserAdvancedStats Prohibited Authorized Authorized Authorized tak Powrót do zaawansowanych statystyk konta zalogowanego użytkownika
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
Główne
getData Authorized Authorized Authorized Authorized nie powrót do głównych informacji na temat banku zdjęć Fotolia
test Authorized Authorized Authorized Authorized nie powrót zakończony powodzeniem
Reseller API
user.subaccount.getIds Prohibited Prohibited Prohibited Authorized nie Powrót do zbioru ID wszystkich dostępnych subkont
user.subaccount.create Prohibited Prohibited Prohibited Authorized nie Utwórz subkonto reseller
user.subaccount.delete Prohibited Prohibited Prohibited Authorized nie Usuń subkonto reseller
user.subaccount.edit Prohibited Prohibited Prohibited Authorized nie Aktualizuj dane subkonta reseller
user.subaccount.get Prohibited Prohibited Prohibited Authorized nie Idź do szczegółów subkonta reseller
user.subaccount.getPurchasedContents Prohibited Prohibited Prohibited Authorized nie Idź do listy zakupów zrealizowanych przez subkonto
media.getLicense Prohibited Prohibited Prohibited Authorized nie Idź do umowy licencyjnej pomiędzy resellerem a jego klientem dotyczącej określonej sprzedaży.

Format Zapytania

XML/RPC

Format XML/RPC dostępny jest dla wymiany danych (pytanie/odpowiedź). XML/RPC jest protokołem RPC (Remote Procedure Call) pracującym w Internecie. Przesyłanie wiadomości XML-RPC odbywa się z wykorzystaniem protokołu HTTP-POST. Przesyłane parametry i wyniki formułowane są w formacie XML. więcej informacji na temat XML/RPC

Nagłówek


POST /Xmlrpc/rpc HTTP/1.0
Host: api.fotolia.com
Connection: close
Content-Type: text/xml
Content-Length: 569

Przykład Zapytania


<?xml version="1.0" encoding="utf-8"?>
<methodCall>
	<methodName>xmlrpc.test</methodName>
	<params>
		<param>
			<value>
				<string>YOUR_API_KEY</string>
			</value>
		</param>
	</params>
</methodCall>

Przykład Odpowiedzi


<?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>

Zestawy API

Możesz użyć zestawu w celu uproszczenia sposobu użycia API. Poniżej znajduje się lista dostępnych zestawów. Jeśli chcesz zaproponować swój własny zestaw, skontaktuj się z nami.

PHP

Ruby