API de XML-RPC

← Back

Connecting
Ponto Final API: https://secure.gravatar.com/xmlrpc?user=[email_hash]

É obrigatório que você se conecte a secure.gravatar.com através de HTTPS para a segurança dos nossos usuários. O parâmetro GET email_hash é o hash md5 do endereço de email dos usuários depois de transformados em minúsculas e reduzidos.

Todos os parâmetros de todos os métodos devem ser passado como um único item, dentro de uma matriz associativa.

Autenticação
A autenticação do usuário acontece no nível de método da API. Você vai passar para a chamada de método um parâmetro de senha. Os dados para esses parâmetros serão passados ​​em texto simples. O parâmetro de senha é sempre retirado dos argumentos antes dos métodos começarem seu processamento. Por esta razão, você deve esperar para não vê-lo retornado de grav.test method.

Erros
Erros geralmente vêm com um número e texto legível. Geralmente, o texto deve ser seguido sempre que possível, mas uma breve descrição dos códigos de erro numéricos são as seguintes:

	-7	Use secure.gravatar.com 
	-8	Erro interno 
	-9	Erro de autenticação 
	-10	Método de parâmetro em falta 
	-11	Método de parâmetro incorreto 
	-100	Misc erro (ver texto) 

Métodos
grav.exists - checar se há um erro com um gravatar 
	@param  (array)$args['hashes'] um vetor de hashes para verificar 
	@param	(string)$args['password'] para autenticação 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - obtenha uma lista de endereços para esta conta 
	@param  (string)$args['password'] para autenticação 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - retorna um vetor de imagens de usuário para esta conta 
	@param  (string)$args['password'] para autenticação 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - Salvar dados binários da imagem como uma userimage para esta conta 
	@param  (string)$args['data'] a base64_encode()d image
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] para autenticação 
	@return (bool)false em caso de falha, (string)userimage em caso de sucesso 

grav.saveUrl - Ler uma imagem através da sua URL e salvar como userimage para esta conta 
	@param  (string)$args['url'] uma url completa para uma imagem 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] para autenticação 
	@return (bool)false em caso de falha, (string)userimage em caso de sucesso 

grav.useUserimage - usar uma imagem como um gravatar para mais um dos endereços nesta conta  
	@param  (string)$args['userimage'] A imagem que você deseja usar 
	@param  (array)$args['addresses'] A lista de endereços de email que você deseja usar para esta imagem 
	@param  (string)$args['password'] para autenticação 
	@return array(
		address => (bool)status
	)

grav.removeImage - remover a imagem associada à um ou mais endereços de e-mail 
	@param  (array)$args['addresses'] A lista de endereços de email que você deseja usar para esta imagem 
	@param  (string)$args['password'] para autenticação 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - remover uma imagem da conta e de todos os endereços de email com o qual está associado 
	@param  (string)$args['userimage'] A imagem que você deseja remover da conta 
	@param  (string)$args['password'] para autenticação 
	@return (bool)status

grav.test - a test function
	@param  (string)$args['password'] para autenticação 
	@return (mixed)$args