API Key
Para utilizar a API, necessita de uma chave API. A chave API é necessária para fazer qualquer consulta através da API. Poderá obter uma chave API, indo à seção "Caixa de Ferramentas" e preenchendo o formulário API. Três tipos de chave API estão disponíveis : chave API parceiros, chave API criativos e chave API negócios. Dependendo da chave API que pediu, algumas funcionalidades poderão não estar disponíveis. Consulte a tabela abaixo para rever os métodos disponíveis para si. É possível adquirir chaves API múltiplas. Cada aplicação criada deverá ser associada com uma chave API diferente.
Termos de uso
Os termos da API regem os direitos e condições em que cada API pode ser usada. Por favor reveja o termo de uso da API para saber qual é a API apropriada para si.
Codificação
A API do Fotolia, requer toda a informação em UTF-8 encoded. Mais informação sobre UTF-8 encoding
XML-RPC API Obsoleta
se já implementou a nossa API usando o servidor obsoleto XML-RPC, poderá continuar a ter acesso à sua documentação. Aconselhamos-lhe a atualizá-la para usar a nova REST API que não será mais atualizada
Autenticação
Alguns métodos precisam de ser autenticados (ver tabela abaixo). A autenticação está disponível apenas para API criativos e API Negócios. O processo de autenticação é equivalente ao processo de login no site Fotolia. O login e a senha devem ser enviados de forma segura através da API e quando autenticada, um ID de sessão será fornecido. Este ID de sessão será então necessário para a utilização de métodos com autenticação. Para mais informações sobre a autenticação, por favor consulteloginUser.
Cota de chamadas API
O Fotolia limita o número de chamadas API por defeito a 500 por hora e 10000 por dia support.
Métodos
Os Métodos tornam possível a execução de diferentes funções através da API. A tabela a seguir, dá a informação sobre os métodos disponíveis para cada tipo de API. Outros métodos serão brevemente adicionados.
| Métodos | API Parceiro | API Negócios | API Criativos | APU Reseller | Autenticação | Descrição | ||
|---|---|---|---|---|---|---|---|---|
| Pesquisa | ||||||||
| getSearchResults |  |
|
|
|
não | capacidades de pesquisa totais | ||
| getCategories1 | |
|
|
|
não | regressar às categorias representativas | ||
| getCategories2 | |
|
|
|
não | regressar às categorias concetuais | ||
| getTags | |
|
|
|
não | regressar às tag cloud | ||
| getGalleries | |
|
|
|
não | regressar às galerias públicas | ||
| getSeasonalGalleries | |
|
|
|
não | regressar às pesquisas sazonais | ||
| getCountries | |
|
|
|
não | regressar à lista dos países | ||
| Media | ||||||||
| getMediaData | |
|
|
|
não | regressar a toda informação sobre média | ||
| getBulkMediaData | |
|
|
|
no | Recuperar toda a informação sobre um ou mais suportes de Mídia | ||
| getMediaGalleries | |
|
|
|
não | regressar às galerias ligadas aos média | ||
| getMedia | |
|
|
|
sim | regressar ao link de download (compra de média) | ||
| getMediaComp | |
|
|
|
não | regressar ao url da imagem em miniatura | ||
| User | ||||||||
| loginUser | |
|
|
|
não | ligar um usuário (necessárias para autenticação) | ||
| refreshToken | |
|
|
|
no | Renew authentication token | ||
| userSignUp | |
|
|
|
no | Create a new Fotolia user | ||
| userEditProfile | |
|
|
|
yes | Update the profile of a Fotolia's member | ||
| getUserData | |
|
|
|
sim | regressar à informação sobre o usuário ligado | ||
| getSalesData | |
|
|
|
yes | Obter a informação das vendas realizadas por um usuário | ||
| getUserStats | |
|
|
|
sim | regressar às estatísticas da conta do usuário ligado | ||
| getUserGalleries | |
|
|
|
sim | regressar às galerias do usuário ligado | ||
| getUserGalleryMedias | |
|
|
|
sim | regressar à lightbox/galeria de arquivos do usuário ligado | ||
| deleteUserGallery | |
|
|
|
sim | Eliminar a galeria do usuário ligado | ||
| createUserGallery | |
|
|
|
sim | criar uma nova galeria para o usuário ligado | ||
| addToUserGallery | |
|
|
|
sim | adicionar um arquivo à galeria do usuário ligado | ||
| removeFromUserGallery | |
|
|
|
sim | remover um arquivo da galeria do usuário ligado | ||
| 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 | |
|
|
|
sim | regressar às estatísticas avançadas do usuário ligado | ||
| 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 | ||
| Carrinho de Compras | ||||||||
| shoppingcart.getList | |
|
|
|
sim | regressar aos arquivos do carrinho de compras | ||
| shoppingcart.add | |
|
|
|
sim | adicionar média ao carrinho de compras do usuário | ||
| shoppingcart.update | |
|
|
|
sim | atualizar média ao carrinho de compras do usuário | ||
| shoppingcart.remove | |
|
|
|
sim | remover média do carrinho de compras do usuário | ||
| shoppingcart.transferToLightbox | |
|
|
|
sim | remover média do carrinho de compras do usuário e adicioná-la à sua lightbox | ||
| shoppingcart.clear | |
|
|
|
sim | esvaziar o carrinho de compras do usuário | ||
| Main | ||||||||
| getData | |
|
|
|
não | regressar à informação geral sobre o Fotolia | ||
| test | |
|
|
|
não | regresso bem sucedido | ||
| API Reseller | ||||||||
| user.subaccount.getIds | |
|
|
|
não | retorna uma matriz de todos os IDs disponíveis de subcontas | ||
| user.subaccount.create | |
|
|
|
não | criar uma subconta de reseller | ||
| user.subaccount.delete | |
|
|
|
não | eliminar uma subconta de reseller | ||
| user.subaccount.edit | |
|
|
|
não | atualizar a informação de uma subconta de reseller | ||
| user.subaccount.get | |
|
|
|
não | obter detalhes de uma subconta resseler | ||
| user.subaccount.getPurchasedContents | |
|
|
|
não | obter uma lista de compras realizadas por uma subconta | ||
| media.getLicense | |
|
|
|
não | obter a licença entre o reseller e seu cliente para uma venda específica | ||
Formato de consulta
HTTP
A API do Fotolia é uma REST API, disponível via chamadas HTTP standart, usando o método GET para métodos de leitura única, o método POST pata métodos que modificam a informação ou fazem o log do usuário, e a sequência de consulta padrão para passar argumentos.
Mais informação sobre REST.
para usar a REST API, cada pedido deve ser enviado usando a sua chave API como nome de usuário HTTP, e uma sequência vazia (para métodos públicos) ou um token de sessão (por métodos que exigem autenticação) como a senha HTTP.
URL Base
O URL base para a REST API é: http://api.fotolia.com/Rest/1/
Formato de retorno
A informação devolvida pela REST API é formatada em JSON, um formato que pode ser analisado em mais linguagens de programação modernas.
Mais informações sobre JSON.
Exemplo de Consulta
Neste exemplo, chamamos o método main/test com a chave API 'exampleApiKey' como nome de usuário HTTP , e uma password HTTP vazia a partir da altura em que o método é público. O cabeçalho da autorização, portanto usa, o string base64 codificado 'exampleApiKey:'.
GET /Rest/1/main/test HTTP/1.0
Host: api.fotolia.com
Autorização: Basic ZXhhbXBsZUFwaUtleTo=
Os métodos que são chamados usando GET podem também ser chamados diretamente pela URL, então URL neste exemplo seria: http://exampleApiKey:@api.fotolia.com/Rest/1/main/test
Exemplo de Resposta
{
"test":"Success"
}
Kits API
Poderá usar um kit para o ajudar a simplificar a maneira como você usa a API. Aqui encontra a lista de Kits disponíveis. Se quiser propor o seu kit, não hesite em contatar-nos. Temos muito gosto em redireciona-lo para seu site.
