API Key
requisito Per utilizzare un'API Fotolia è necessaria una API key. l'API key è essenziale per lanciare query tramite l'API. Puoi ottenere la API key dalla sezione “Strumenti” del tuo account Fotolia, completando il modulo API. Sono disponibili 3 tipi di API: l'API key Partner, API Key Sviluppo e l' API key Business. 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 le Condizioni di utilizzo API per un uso corretto dell'API prima di installarla.
Codifica
L' API Fotolia richiede la codifica UTF-8 dei dati. Informazioni sulla codifica UTF-8
XML-RPC API dismessa
Se hai già implementato una nostra API tramite il server XML-RPC deprecato, puoi ancora accedere alla sua documentazione. Ti raccomandiamo vivamente di aggiornare la tua API secondo la nuova REST API perchè il sistema deprecato non verrà più aggiornato
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 processo di login sul sito Fotolia. Il login e la password devono essere trasmesse tramite collegamento sicuro attraverso l'API. Dopo l'autenticazione, 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 loginUser.
Quota di API calls
Fotolia limita il numero delle API calls a 500/ora e a 10000/giorno.
Se il traffico del tuo sito richiede una quota maggiore, contatta il supporto.
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 | API Partner | API Business | API Sviluppo | API Rivenditore | Autenticazione | Descrizione | ||
|---|---|---|---|---|---|---|---|---|
| Search | ||||||||
| getSearchResults |  |
|
|
|
no | Piena capacità di ricerca | ||
| getCategories1 | |
|
|
|
no | Risultato: Categorie Rappresentative | ||
| getCategories2 | |
|
|
|
no | Risultato: Categorie Concettuali | ||
| getTags | |
|
|
|
no | return tag cloud | ||
| getGalleries | |
|
|
|
no | Risultato: Gallerie Pubbliche | ||
| getSeasonalGalleries | |
|
|
|
no | Risultato: Ricerche di stagione | ||
| getCountries | |
|
|
|
no | Risultato: Liste Paesi | ||
| Media | ||||||||
| getMediaData | |
|
|
|
no | Risultato: informazioni complete file | ||
| getBulkMediaData | |
|
|
|
no | Ritorna tutte le informazioni di uno o più supporti | ||
| getMediaGalleries | |
|
|
|
no | Risultato: gallerie associate ad un file | ||
| getMedia | |
|
|
|
yes | Risultato: link di download (acquisto file) | ||
| getMediaComp | |
|
|
|
no | Risultato: url dell'anteprima file | ||
| User | ||||||||
| loginUser | |
|
|
|
no | Login utente (essenziale per l'autenticazione) | ||
| refreshToken | |
|
|
|
no | Renew authentication token | ||
| userSignUp | |
|
|
|
no | Create a new Fotolia user | ||
| userEditProfile | |
|
|
|
yes | Update the profile of a Fotolia's member | ||
| getUserData | |
|
|
|
yes | Risultato: informazioni sull'utente loggato | ||
| getSalesData | |
|
|
|
yes | ritorna dati di vendita di utente loggato | ||
| getUserStats | |
|
|
|
yes | Risultato: statistiche account di utente loggato | ||
| getUserGalleries | |
|
|
|
yes | Risultato: gallerie di un utente loggato | ||
| getUserGalleryMedias | |
|
|
|
yes | Risultato: lightbox/gallerie di un utente loggato | ||
| deleteUserGallery | |
|
|
|
yes | Cancella una galleria di un utente loggato | ||
| createUserGallery | |
|
|
|
yes | crea una nuova galleria per un utente loggato | ||
| addToUserGallery | |
|
|
|
yes | aggiungi contenuto a una galleria di un utente loggato | ||
| removeFromUserGallery | |
|
|
|
yes | rimuovi un contenuto da una galleria di un utente loggato | ||
| user.moveUpMediaInUserGallery | |
|
|
|
yes | move up a media in an user galleryr | ||
| user.moveDownMediaInUserGallery | |
|
|
|
yes | move down a media in an user gallery | ||
| user.moveMediaToTopInUserGallery | |
|
|
|
yes | move a media to top position in an user gallery | ||
| getUserAdvancedStats | |
|
|
|
yes | Risultato: statistiche avanzate di un utente loggato | ||
| getLastOnlineContents | |
|
|
|
Oui | Return last online files of the current user | ||
| getUploadFolders | |
|
|
|
Oui | Return the upload folders list of the authenticated contributor | ||
| getUploadFolderFileIds | |
|
|
|
yes | return file IDs inside an upload folder | ||
| uploadIdCard | |
|
|
|
Yes | Upload a new contributor ID card | ||
| upload | |
|
|
|
Yes | Upload a new file into user's account | ||
| getLastUploadedMedia | |
|
|
|
Yes | List the uploads made the last 7 days | ||
| Shopping cart | ||||||||
| shoppingcart.getList | |
|
|
|
yes | Risultato: contenuto del carrello | ||
| shoppingcart.add | |
|
|
|
yes | Aggiungi un file al carrello di un utente | ||
| shoppingcart.update | |
|
|
|
yes | Aggiorna un file nel carrello di un utente | ||
| shoppingcart.remove | |
|
|
|
yes | Rimuovi un file dal carrello di un utente | ||
| shoppingcart.transferToLightbox | |
|
|
|
yes | Rimuovi un file dal carrello di un utente e aggiungilo al suo lightobx | ||
| shoppingcart.clear | |
|
|
|
yes | Svuota il carrello | ||
| Principale | ||||||||
| getData | |
|
|
|
no | Risultato: informazioni generali su Fotolia | ||
| test | |
|
|
|
no | Risulta "successo" | ||
| API Rivenditore | ||||||||
| user.subaccount.getIds | |
|
|
|
no | Risultato: un ordine di tutti gli ID di sub-account 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 | Ottieni dettagli sub-account rivenditore | ||
| user.subaccount.getPurchasedContents | |
|
|
|
no | Ottieni lista di acquisti fatti da un sub-account | ||
| media.getLicense | |
|
|
|
no | Ottieni licenza tra il rivenditore e il suo cliente per una vendita specifica. | ||
Formato Query
HTTP
La API Fotolia è una API REST disponibile via calls standard HTTP, utilizzando i metodi GET for read-only, il metodo POST per metodi che modificano dati oppure loggano l'utente, e la stringa di query standard per passare gli argomenti.
Per saperne di più su REST.
Per usare la API REST, ogni richiesta deve essere inviata usando la tua API key come username HTTP, e sia una stringa vuota (per metodi pubblici) oppure un session token (per metodi che richiedono autenticazione) come password HTTP.
Base URL
La URL di base per la API REST è: http://api.fotolia.com/Rest/1/
Formato risultante
Il dato risultante dalla API REST è formattato in JSON, un formato che può essere analizzato con la maggior parte dei moderni linguaggi di programmazione.
per saperne di più su JSON.
Esempio di Query
In questo esempio, chiamiamo il metodo main/test con la API key 'exampleApiKey' come username HTTP, e una password HTTP vuota poichè il metodo è pubblico. L'intestazione di autorizzazione utilizza quindi la stringa con codifica Base64 'exampleApiKey:'.
GET /Rest/1/main/test HTTP/1.0
Host: api.fotolia.com
Autorizzazione: Basic ZXhhbXBsZUFwaUtleTo=
I metodi che sono richiamati usando GET possono essere richiamati anche direttamente dalla URL, così la URL in questo esempio sarà: http://exampleApiKey:@api.fotolia.com/Rest/1/main/test
Esempio di Risposta
{
"test":"Success"
}
Kit API
Puoi usare un kit per semplificare il modo in cui utilizzi una API. Qui di seguito una lista di kit disponibili. Non esitare a contattarci se vuoi proporre un tuo kit, ben volentieri potremo dirigerlo sul tuo sito.
