968 701 497

22 414 593 imagens de alta definição
para todos os usos profissionais

Carrinho de Compras
Meu carrinho
( 0 )
 
Todos

question-mark

Como usar o API Fotolia?

API
Documentação
Condições Gerais

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 à secçã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 Authorized Authorized Authorized Authorized não capacidades de pesquisa totais
getCategories1 Authorized Authorized Authorized Authorized não regressar às categorias representativas
getCategories2 Authorized Authorized Authorized Authorized não regressar às categorias conceptuais
getTags Authorized Authorized Authorized Authorized não regressar às tag cloud
getGalleries Authorized Authorized Authorized Authorized não regressar às galerias públicas
getSeasonalGalleries Authorized Authorized Authorized Authorized não regressar às pesquisas sazonais
getCountries Authorized Authorized Authorized Authorized não regressar à lista dos países
Media
getMediaData Authorized Authorized Authorized Authorized não regressar a toda informação sobre média
getBulkMediaData Authorized Authorized Authorized Authorized no Recuperar toda a informação sobre um ou mais suportes de Media
getMediaGalleries Authorized Authorized Authorized Authorized não regressar às galerias ligadas aos média
getMedia Prohibited Authorized Prohibited Authorized sim regressar ao link de download (compra de média)
getMediaComp Authorized Authorized Authorized Authorized não regressar ao url da imagem em miniatura
User
loginUser Authorized Authorized Authorized Authorized não ligar um utilizador (necessárias para autenticação)
refreshToken Authorized Authorized Authorized Authorized no Renew authentication token
userSignUp Authorized Authorized Authorized Authorized no Create a new Fotolia user
userEditProfile Authorized Authorized Authorized Authorized yes Update the profile of a Fotolia's member
getUserData Authorized Authorized Authorized Authorized sim regressar à informação sobre o utilizador ligado
getSalesData Authorized Authorized Authorized Authorized yes Obter a informação das vendas realizadas por um utilizador
getUserStats Authorized Authorized Authorized Authorized sim regressar às estatísticas da conta do utilizador ligado
getUserGalleries Authorized Authorized Authorized Authorized sim regressar às galerias do utilizador ligado
getUserGalleryMedias Authorized Authorized Authorized Authorized sim regressar à lightbox/galeria de ficheiros do utilizador ligado
deleteUserGallery Authorized Authorized Authorized Authorized sim Eliminar a galeria do utilizador ligado
createUserGallery Authorized Authorized Authorized Authorized sim criar uma nova galeria para o utilizador ligado
addToUserGallery Authorized Authorized Authorized Authorized sim adicionar um ficheiro à galeria do utilizador ligado
removeFromUserGallery Authorized Authorized Authorized Authorized sim remover um ficheiro da galeria do utilizador ligado
user.moveUpMediaInUserGallery Authorized Authorized Authorized Authorized yes move up a media in an user galleryr
user.moveDownMediaInUserGallery Authorized Authorized Authorized Authorized yes move down a media in an user gallery
user.moveMediaToTopInUserGallery Authorized Authorized Authorized Authorized yes move a media to top position in an user gallery
getUserAdvancedStats Authorized Authorized Authorized Authorized sim regressar às estatísticas avançadas do utilizador ligado
getLastOnlineContents Authorized Authorized Authorized Authorized Oui Return last online files of the current user
getUploadFolders Authorized Authorized Authorized Authorized Oui Return the upload folders list of the authenticated contributor
getUploadFolderFileIds Authorized Authorized Authorized Authorized yes return file IDs inside an upload folder
uploadIdCard Authorized Authorized Authorized Authorized Yes Upload a new contributor ID card
upload Authorized Authorized Authorized Authorized Yes Upload a new file into user's account
getLastUploadedMedia Authorized Authorized Authorized Authorized Yes List the uploads made the last 7 days
Carrinho de compras
shoppingcart.getList Prohibited Authorized Prohibited Authorized sim regressar aos ficheiros do carrinho de compras
shoppingcart.add Prohibited Authorized Prohibited Authorized sim adicionar média ao carrinho de compras do utilizador
shoppingcart.update Prohibited Authorized Prohibited Authorized sim atualizar média ao carrinho de compras do utilizador
shoppingcart.remove Prohibited Authorized Prohibited Authorized sim remover média do carrinho de compras do utilizador
shoppingcart.transferToLightbox Prohibited Authorized Prohibited Authorized sim remover média do carrinho de compras do utilizador e adicioná-la à sua lightbox
shoppingcart.clear Prohibited Authorized Prohibited Authorized sim esvaziar o carrinho de compras do utilizador
Main
getData Authorized Authorized Authorized Authorized não regressar à informação geral sobre o Fotolia
test Authorized Authorized Authorized Authorized não regresso bem sucedido
API Reseller
user.subaccount.getIds Prohibited Prohibited Prohibited Authorized não retorna uma matriz de todos os IDs disponíveis de subcontas
user.subaccount.create Prohibited Prohibited Prohibited Authorized não criar uma subconta de reseller
user.subaccount.delete Prohibited Prohibited Prohibited Authorized não eliminar uma subconta de reseller
user.subaccount.edit Prohibited Prohibited Prohibited Authorized não atualizar a informação de uma subconta de reseller
user.subaccount.get Prohibited Prohibited Prohibited Authorized não obter detalhes de uma subconta resseler
user.subaccount.getPurchasedContents Prohibited Prohibited Prohibited Authorized não obter uma lista de compras realizadas por uma subconta
media.getLicense Prohibited Prohibited Prohibited Authorized não obter a licença entre o reseller e o 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 utilizador, 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 utilizador 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 utilizador 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 contactar-nos. Temos muito gosto em redireciona-lo para o seu site.

PHP, Java, Python

Fotolia

Informação

Pesquisa

Ferramentas

Comunidade

Fotolia © 2004 - 2013

Idioma

PT flag portugal