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.

Semua parameter untuk semua metode harus diteruskan sebagai satu item, dalam satu larik terkait.

Otentikasi
Autentikasi pengguna dilakukan pada level metode api. Anda akan melanjutkan ke metode yang bernama parameter kata sandi. Data untuk parameter ini akan diteruskan sebagai teks biasa. Parameter kata sandi selalu dipisahkan dari argumen sebelum metode tersebut memulai prosesnya. Untuk alasan ini, Anda tidak akan melihatnya dikembalikan dari metode grav.test.

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