API 端点： https://secure.gravatar.com/xmlrpc?user=[email_hash]

当您连接到secure.gravatar.com，您的传输会强制性经过HTTPS传送。这是基于保障我们所有使用者的安全为由，参数email_hash GET是小写及修整后的用户电邮地址md5 hash。

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.

错误讯息通常会带有一个代码及一段易读的文字。一般而言，那文字如有的话会出现在后，数字错误代码的简述如下：

	-7	使用 secure.gravatar.com 
	-8	内部错误 
	-9	认证错误 
	-10	遗失程序参数 
	-11	程序参数错误 
	-100	杂项错误（见文） 

grav.exists - 检查金钥是否拥有gravatar 
	@param  (array)$args['hashes'] 检查一列金钥 
	@param	(string)$args['password'] 认证专用 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - 为这个帐户取得电邮地址名单 
	@param  (string)$args['password'] 认证专用 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - 返回此帐户的一列用户图像 
	@param  (string)$args['password'] 认证专用 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - 将二进制图像数据转为此帐户的用户图像 
	@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'] 认证专用 
	@return (bool)false 失败, (string)userimage 成功 

grav.saveUrl - 透过URL观看图像并将它储存为用户图像 
	@param  (string)$args['url'] 从一个完整网址到一个图像 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] 认证专用 
	@return (bool)false 失败, (string)userimage 成功 

grav.useUserimage - 使用一个用户图像作为gravatar于一个或多个电邮地址 
	@param  (string)$args['userimage'] 您希望使用的用户图像 
	@param  (array)$args['addresses'] 您希望使用此帐户图像于此电邮地址列表 
	@param  (string)$args['password'] 认证专用 
	@return array(
		address => (bool)status
	)

grav.removeImage - 移除与一个或多个电邮地址有联系的用户图像 
	@param  (array)$args['addresses'] 您希望使用此帐户图像于此电邮地址列表 
	@param  (string)$args['password'] 认证专用 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - 移除帐户内的用户图像及任何有联系的电邮地址 
	@param  (string)$args['userimage'] 您希望从帐户移除的用户图像 
	@param  (string)$args['password'] 认证专用 
	@return (bool)status

grav.test - a test function
	@param  (string)$args['password'] 认证专用 
	@return (mixed)$args