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

Het is verplicht dat je via HTTPS verbinding maakt met secure.gravatar.com. Dit is voor de veiligheid van onze wederzijdse gebruikers. De GET parameter email_hash is de md5 hash van het gebruikers e-mailadres nadat deze is gewijzigd naar kleine letters, en spaties zijn verwijderd aan het begin en het eind.

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

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.

Foutboodschappen verschijnen meestal met een nummer en een leesbare tekst. In het algemeen moet je deze tekst aanhouden indien mogelijk, een korte omschrijving van de numerieke foutboodschappen zijn als volgt:

	-7	Gebruik secure.gravatar.com 
	-8	Internefout 
	-9	Authenticatiefout 
	-10	Methode parameter ontbreekt 
	-11	Methode parameter onjuist 
	-100	Overige fout (zie tekst) 

grav.exists - controleer of de hash een gravatar heeft 
	@param  (array)$args['hashes'] een array van te controleren hashes 
	@param	(string)$args['password'] voor authenticatie 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - verkrijg een lijst van adressen voor dit account 
	@param  (string)$args['password'] voor authenticatie 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - verkrijg een array van gebruikersafbeeldingen van dit account 
	@param  (string)$args['password'] voor authenticatie 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - Bewaar de binaire afbeelding gegevens als gebruikersafbeelding voor dit 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'] voor authenticatie 
	@return (bool)false indien fout, (string)userimage indien goed 

grav.saveUrl - Lees een afbeelding via een URL en bewaar deze als gebruikersafbeelding voor dit account 
	@param  (string)$args['url'] Een volledige url naar een afbeelding 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] voor authenticatie 
	@return (bool)false indien fout, (string)userimage indien goed 

grav.useUserimage - gebruik de gebruikersafbeelding als gravatar voor een of meer e-mailadressen op dit account 
	@param  (string)$args['userimage'] De gebruikersafbeelding de je wenst te gebruiken 
	@param  (array)$args['addresses'] Een lijst van e-mailadressen welke jij wenst te gebruiken voor deze gebruikersafbeelding 
	@param  (string)$args['password'] voor authenticatie 
	@return array(
		address => (bool)status
	)

grav.removeImage - verwijderen een gebruikersafbeelding geassocieerd met een of meerdere e-mailadressen 
	@param  (array)$args['addresses'] Een lijst van e-mailadressen welke jij wenst te gebruiken voor deze gebruikersafbeelding 
	@param  (string)$args['password'] voor authenticatie 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - verwijder een gebruikersafbeelding en het geassocieerde e-mailadres van het account  
	@param  (string)$args['userimage'] De gebruikersafbeelding u wenst te verwijderen van dit account 
	@param  (string)$args['password'] voor authenticatie 
	@return (bool)status

grav.test - a test function
	@param  (string)$args['password'] voor authenticatie 
	@return (mixed)$args