XML-RPC API

← Back

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

It is mandatory that you connect to secure.gravatar.com, and that you do so over HTTPS. This is for the safety of our mutual users. The email_hash GET parameter is the md5 hash of the users email address after it has been lowercased, and trimmed.

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

Otentikasi
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.

Kesalahan
Kesalahan biasanya datang dengan nomor dan teks yang dapat dibaca. Umumnya teks harus diikuti bila memungkinkan, tapi deskripsi singkat dari kode kesalahan numerik adalah sebagai berikut:

	-7	Gunakan secure.gravatar.com 
	-8	kesalahan internal 
	-9	Kesalahan otentikasi 
	-10	Metode parameter hilang 
	-11	Metode parameter tidak benar 
	-100	Misc error (lihat teks) 

Metode
grav.exists - memeriksa apakah hash memiliki Gravatar 
	@param  (array)$args['hashes'] sebuah array dari hash untuk memeriksa 
	@param	(string)$args['password'] untuk otentikasi 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - dapatkan daftar alamat untuk akun ini 
	@param  (string)$args['password'] untuk otentikasi 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - kembalikan sebuah array dari gambar pengguna untuk akun ini 
	@param  (string)$args['password'] untuk otentikasi 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - Simpan data citra biner sebagai gambar pengguna untuk akun ini 
	@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'] untuk otentikasi 
	@return (bool)false dalam kegagalan, (string)userimage dalam sukses 

grav.saveUrl - Lihat gambar melalui URL dan simpan sebagai gambar pengguna untuk akun ini 
	@param  (string)$args['url'] url penuh untuk gambar 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] untuk otentikasi 
	@return (bool)false dalam kegagalan, (string)userimage dalam sukses 

grav.useUserimage - gunakan gambar pengguna sebagai Gravatar untuk satu atau lebih alamat email pada akun ini 
	@param  (string)$args['userimage'] Gambar pengguna yang ingin anda gunakan 
	@param  (array)$args['addresses'] Daftar alamat email yang ingin anda gunakan untuk gambar pengguna 
	@param  (string)$args['password'] untuk otentikasi 
	@return array(
		address => (bool)status
	)

grav.removeImage - hapus gambar pengguna yang berhubungan dengan satu atau lebih alamat email 
	@param  (array)$args['addresses'] Daftar alamat email yang ingin anda gunakan untuk gambar pengguna 
	@param  (string)$args['password'] untuk otentikasi 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - hapus gambar pengguna dari setiap akun dan alamat email yang terkait 
	@param  (string)$args['userimage'] Anda ingin menghapus gambar pengguna dari akun 
	@param  (string)$args['password'] untuk otentikasi 
	@return (bool)status

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