XML-RPC API

← Back

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

%Egrave; obbligatorio collegarsi a secure.gravatar.com, e che lo si faccia tramite HTTPS. Ciò per la sicurezza dei nostri utenti comuni. Il parametro GET email_hash è l'hash md5 dell'indirizzo email dell'utente dopo che questi è stato reso minuscolo e accorciato (se necessario).

All parameters for all methods should be passed as a single item, within an associative array.

Autenticazione
User authentication happens at the api method level. You will pass to the method call a password parameter. The data for these parameters will be passed in plain text. The password param is always stripped from the arguments before the methods begin their processing. For this reason you should expect not to see it returned from the grav.test method.

Errori
Gli errori solitamente appaiono con un numero ed un testo in chiaro. E di base al testo viene fatta seguire, se possibile, una breve descrizione del codice numerico di errore come in questo esempio:

	-7	Utilizzare secure.gravatar.com 
	-8	Errore interno 
	-9	Errore di autenticazione 
	-10	Parametro metodo mancante 
	-11	Parametro metodo non corretto 
	-100	Errore di altro tipo (vedi testo) 

Metodi
grav.exists - contralla se un hash ha un gravatar 
	@param  (array)$args['hashes'] un array di hash da controllare 
	@param	(string)$args['password'] per l'autenticazione 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - ottieni un elenco di indirizzi per questo account 
	@param  (string)$args['password'] per l'autenticazione 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - restituisce un array di immagini utente per questo account 
	@param  (string)$args['password'] per l'autenticazione 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - Salva i dati binari di immagine come una immagine utente per questo account 
	@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'] per l'autenticazione 
	@return (bool)false in caso di fallimento, (string)userimage in caso di successo 

grav.saveUrl - Legge una immagine tramite la sua URL e la salva come immagine utente per questo account 
	@param  (string)$args['url'] una url completa ad una immagine 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] per l'autenticazione 
	@return (bool)false in caso di fallimento, (string)userimage in caso di successo 

grav.useUserimage - utiliza una immagine utente come gravatar per uno o più indirizzi di questo account 
	@param  (string)$args['userimage'] L'immagine utente che desideri utilizzare 
	@param  (array)$args['addresses'] Una lista di indirizzi email che desideri utilizzare con questa  immagine utente 
	@param  (string)$args['password'] per l'autenticazione 
	@return array(
		address => (bool)status
	)

grav.removeImage - rimuovi l'immagine associata ad uno o più indirizzi mail 
	@param  (array)$args['addresses'] Una lista di indirizzi email che desideri utilizzare con questa  immagine utente 
	@param  (string)$args['password'] per l'autenticazione 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - rimuovere un'immagine dall'account e tutti gli indirizzi email a cui è associata 
	@param  (string)$args['userimage'] L'immagine che desideri rimuore dall'account 
	@param  (string)$args['password'] per l'autenticazione 
	@return (bool)status

grav.test - a test function
	@param  (string)$args['password'] per l'autenticazione 
	@return (mixed)$args