API エンドポイント: https://secure.gravatar.com/xmlrpc?user=[email_hash]

secure.gravatar.com に HTTPS 経由で接続する必要があります。これはユーザー相互の安全のためです。email_hash GET のパラメータは、ユーザーのメールアドレスをすべて小文字化してトリムした MD5 ハッシュです。

すべてのメソッドの全パラメータは、連想配列内で単一のアイテムとして渡す必要があります。

ユーザー認証は API メソッドレベルで行われます。パスワード変数をメソッドコールに渡すと、これらの変数のデータがプレーンテキストで渡されます。パスワード変数は常に、メソッドの処理が始まる前に引数から切り分けられます。このため、grav.test メソッドからは返されないことを予期しておくべきです。

エラーは、普通は数字と人間が読むことのできるテキストで表示されます。通常、可能な場合には数字のエラーコードの簡単な説明がテキストで続きます:

	-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'] 画像の完全な 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 - 1つまたは複数のメールアドレスに関連付けられているユーザー画像を削除 
	@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