API Key

Per utilizzare un'API Fotolia è necessaria una API key. l'API key è essenziale perchè il nostro database possa essere interrogato tramite l'API. Puoi ottenere la API key dalla sezione “Toolbox” del tuo account Fotolia, completando il modulo API. Sono disponibili 3 tipi di API: l'API Partner, l' API key Business e la API Key Sviluppo, Non tutti i metodi sono applicabili in ogni API. Verifica la tabella qui sotto per sapere quali metodi sono disponibili per te. E' possibile avere key API multiple. Ad ogni applicazione va associata una key API specifica.

Condizioni di utilizzo

Le Condizioni di utilizzo regolamentano i diritti e le condizioni alle quali si può utilizzare ogni API. Si raccomanda di verificare API Condizioni di Utilizzo per un uso corretto dell'API prima di installarla.

Codifica

L' API Fotolia richiede la codifica UTF-8 dei dati. maggiori informazioni sulla codifica UTF-8

Autenticazione

Alcuni metodi richiedono l'autenticazione (vedi tabella). L'autenticazione è disponibile soltanto per le API Business e le API Sviluppo. Il processo di autenticazione corrisponde al login sul sito Fotolia. Il login e la password devono essere trasmesse tramite collegamento sicuro attraverso l'API. Una volta autenticate, verrà fornita una ID di sessione. Tale ID di sessione è necessario per l'utilizzo dei metodi che richiedono autenticazione. Per maggiori info sull'autenticazione rinviamo alla consultazione dei metodi login Utente.

Metodi

I metodi rendono possibile eseguire diverse funzioni tramite l'API. La seguente tabella fornisce informazioni sui metodi disponibili per ogni tipo di applicazione API. Prossimamente è prevista l'aggiunta di altri metodi.

Metodi	Partner API	API Business	API sviluppo	API Rivenditore	Autenticazione	Descrizione
Ricerca
getSearchResults					no	Capacità di ricerca completa
getCategories1					no	Risultato: Categorie Rappresentative
getCategories2					no	Risultato: Categorie Concettuali
getTags					no	risultato: tag cloud
getGalleries					no	Risultato: Gallerie
getColors					no	Risultato: schema colori
getCountries					no	Risultato: elenco Paesi
Immagini
getMediaData					no	Risultato: informazioni sull'immagine
getMediaGalleries					no	Risultato: Gallerie a cui è collegata un'immagine
getMedia					yes	Risultato:link per scaricare un'immagine (acquisto immagine)
getMediaComp					no	Risultato: URL del bozzetto
Utente
loginUser					no	Accesso di un utente registrato (essenziale per l'autenticazione)
logoutUser					yes	Chiusura sessione di un utente registrato (chiudi sessione)
getUserData					yes	Risultato: informazione su un utente registrato
getUserStats					yes	Risultato: statistiche del conto di un utente registrato
getUserGalleries					yes	Risultato: gallerie personali di un utente registrato
getUserGalleryMedias					yes	Ritorna la selezione nelle lightbox/gallerie di un utente loggato
deleteUserGallery					yes	elimina una galleria dall'utente loggato
createUserGallery					yes	crea una nuova galleria per l'utente loggato
addToUserGallery					yes	aggiungi immagini a una galleria di utente loggato
removeFromUserGallery					yes	rimuovi immagini dalla gallerie di un utente loggato
getUserAdvancedStats					yes	mostra statistiche avanzate dell'account dell'utente loggato
Generale
getData					no	Risultato: informazioni generali su Fotolia
test					no	Risultato: "success"
API Reseller
user.subaccount.getIds					no	Ritorna un array di tutti gli ID Utente disponibili
user.subaccount.create					no	Crea un sub-account rivenditore
user.subaccount.delete					no	Cancella un sub-account rivenditore
user.subaccount.edit					no	Aggiorna dati di un sub-account rivenditore
user.subaccount.get					no	Vedi dettagli del sub-account rivenditore
user.subaccount.getPurchasedContents					no	Vedi lista degli acquisti fatti da un sub-account
media.getLicense					no	Vedi licenza tra il reseller e il suo cliente per una vendita specifica.

Formato della query

XML/RPC

Xil formato XML/RPC è disponibile per inviare query e ricevere risultati. XML-RPC è un protocollo di chiamata remota che funziona su Internet. Una chiamata XML-RPC message è una richiesta in metodo HTTP-POST. Il corpo della richiesta è in XML. Viene eseguita una procedura nel server e il valore restituito è anch'esso in formato XML. maggiori info su XML/RPC

Header

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

Esempio di query

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

Esempio di risultato

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

il kit API

E' possibile utilizzare un kit per semplificare il modo in cui viene utilizzata l'API. Questa la lista dei kit disponibili. Se hai un kit da proporci contattaci e se approvato, inseriremo volentieri un link al tuo sito.

PHP

Ruby

Per tutte le domande tecniche relative alle API Fotolia, ti invitiamo a registrarti al google group: http://groups.google.com/group/FotoliaAPI/. In questo gruppo potrai partecipare con i tuoi contributi e domande alla comunità di sviluppatori che ha già sperimentato le funzioni API Fotolia!