Chave API

Para poder utilizar a API Fotolia, deverá ter uma chave API. Essa chave API é indispensável para poder efetuar pedidos a través da API. Pode obter uma chave na seção « Ferramentas » do seu espaço pessoal e preenchendo o formulário API. Estão disponíveis 3 tipos de chaves: a chave API Parceiros, a chave API Negócios e a chave API Criativos. Algumas modalidades podem não estar disponíveis, dependendo da chave que dispõe. Dê uma vista de olhos ao quadro seguinte para verificar quais as modalidades que lhe estão acessíveis. É possível ter várias chaves API. Cada aplicação criada deve ser associada a uma chave API diferente.

Condições Gerais de Utilização da API.

As Condições Gerais de Utilização da API determinam os direitos e condições de utilização de cada API. Agradecíamos que tomasse conhecimento das Condições Gerais de Utilização da API da API apropriada antes de a utilizar.

Code

A API Fotolia necessita que todos os dados estejam codificados em UTF-8. Mais informações sobre l'UTF-8

Autenticação

Alguns métodos necessitam de uma autenticação (ver o quadro mais abaixo). A autenticação só está disponível para a API Criativos e a API Negócios. O processo de identificação é semelhante ao processo de identificação no site Fotolia (Login). Os Logins e Senhas devem ser enviados de modo seguro graças à API e, depois de serem identificados, será atribuído uma ID de sessão. Essa ID de sessão será depois necessária para utilizar os métodos com autenticação. Para mais informações sobre a autenticação, queira consultar o métodoLoginUser.

Métodos

Os métodos permitem executar diferentes funcionalidades a través da API. O quadro seguinte indica os métodos disponíveis para cada tipo de API. Os outros métodos serão acrescentados brevemente.

Métodos API Parceiros API Negócios API Criativos API Reseller Autenticação Descrição
Pesquisa
getSearchResults Authorized Authorized Authorized Authorized não Total capacidade de pesquisa
getCategories1 Authorized Authorized Authorized Authorized não Reenvia as categorias representativas
getCategories2 Authorized Authorized Authorized Authorized não Reenvia as categorias conceptuais
getTags Authorized Authorized Authorized Authorized não Reenvia a núvem de tags
getGalleries Authorized Authorized Authorized Authorized não Reenvia as galerias públicas
getColors Authorized Authorized Authorized Authorized não Reenvia o quadro das cores
getCountries Authorized Authorized Authorized Authorized não Reenvia a lista dos países
Arquivo
getMediaData Authorized Authorized Authorized Authorized não Reenvia todas as informações sobre um arquivo
getMediaGalleries Authorized Authorized Authorized Authorized não Reenvia as galerias relativas ao arquivo
getMedia Prohibited Authorized Prohibited Authorized sim Reenvia o link de download (arquivo comprado)
getMediaComp Authorized Authorized Authorized Authorized não Reenvia o URL da imagem em miniatura
Utilizador
loginUser Prohibited Authorized Authorized Authorized não Identificar um utilizador (necessário para a autentificação)
logoutUser Prohibited Authorized Authorized Authorized sim Desconetar um utilizador (terminar a sessão)
getUserData Prohibited Authorized Authorized Authorized sim Reenvia as informações sobre o utilizador identificado
getUserStats Prohibited Authorized Authorized Authorized sim Reenvia as estatísticas da conta do utilizador identificado
getUserGalleries Prohibited Authorized Authorized Authorized sim Reenvia as galerias do utilizador identificado
getUserGalleryMedias Prohibited Authorized Authorized Authorized sim Reenvia as imagens da lightbox/galeria de um utilizador identificado
deleteUserGallery Prohibited Authorized Authorized Authorized sim eliminar a galeria de um utilizador logado
createUserGallery Prohibited Authorized Authorized Authorized sim criar uma nova galeria para um utilizador logado
addToUserGallery Prohibited Authorized Authorized Authorized sim adicionar um arquivo na galeria de um utilizador logado
removeFromUserGallery Prohibited Authorized Authorized Authorized sim apagar um arquivo da galeria de um utilizador logado
getUserAdvancedStats Prohibited Authorized Authorized Authorized sim obter resultados da pesquisa avançada sobre as estatísticas da conta de um utilizador logado
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
Geral
getData Authorized Authorized Authorized Authorized não Reenvia as informações gerais a propósito de Fotolia
test Authorized Authorized Authorized Authorized no Reenvia "success"
API Reseller
user.subaccount.getIds Prohibited Prohibited Prohibited Authorized não Lista de todos os ID das sub-contas
user.subaccount.create Prohibited Prohibited Prohibited Authorized não Criar uma sub-conta reseller
user.subaccount.delete Prohibited Prohibited Prohibited Authorized não Apagar uma sub-conta reseller
user.subaccount.edit Prohibited Prohibited Prohibited Authorized não Atualizar os dados de uma sub-conta reseller
user.subaccount.get Prohibited Prohibited Prohibited Authorized não Obter detalhes de uma sub-conta reseller
user.subaccount.getPurchasedContents Prohibited Prohibited Prohibited Authorized não Obter a lista das compras efetuadas por uma sub-conta
media.getLicense Prohibited Prohibited Prohibited Authorized não Obter a licença de uma determinada venda entre o revendedor e o seu cliente.

Formato dos pedidos

XML/RPC

O formato XML/RPC é válido para os pedidos e respostas. O XML-RPC é um protocolo (Remote Procedure Calling) que fonciona na Internet. Uma messagem XML-RPC é um pedido HTTP-POST. O corpo do pedido (Body) está em XML. Um procedimento é executado no servidor e o valor que ele reenvia está igualmente formatado em XML. Mais informações sobre o XML/RPC

En-tête


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

Exemplo de pedido


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

Exemplo de resposta


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

Kits API

Pode utilizar um kit que o ajudará a simplificar a sua utilização da API. Veja aqui a lista dos kits disponíveis. Se desejar propor o seu kit, não hesite em nos contatar, poderemos acrescentar um link para o seu site.

PHP

Ruby