XML-RPC API

← Back

Connecting
API krajna tačka: https://secure.gravatar.com/xmlrpc?user=[email_hash]

Obavezno je da se povezujete preko secure.gravatar.com, i da to radite preko HTTPS-a. Ovo je zbog sigurnosti naših zajedničkih korisnika. email_hash GET parametar je md5 hash korisnikove email adrese nakon što je smanjena u mala slova i obrubljena.

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

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

Greške
Greške se najčešće prikazuju brojem i nekim tekstom. Uopće, tekst bi trebalo da se prikazuje kad god je to moguće, a kratak opis brojčanih kodova greški je sljedeći:

	-7	Koristite secure.gravatar.com 
	-8	Interna greška 
	-9	Autentifikacijska greška 
	-10	Nedostaju parametri metode 
	-11	Parametri metode su netačni 
	-100	Greška (pogledajte tekst) 

Metode
grav.exists - provjerite da li hash ima gravatar 
	@param  (array)$args['hashes'] niz hashova za provjeru 
	@param	(string)$args['password'] za autentifikaciju 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - dobij spisak adresa za ovaj račun 
	@param  (string)$args['password'] za autentifikaciju 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - vrati niz korisničkih slika za ovaj račun 
	@param  (string)$args['password'] za autentifikaciju 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - Sačuvaj binarni slikovni podatak kao korisničku sliku za ovaj račun 
	@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'] za autentifikaciju 
	@return (bool)false prilikom neuspjeha, (string)userimage prilikom uspjeha 

grav.saveUrl - Pročitaj sliku pomoću URL-a i sačuvaj je kao korisničku sliku za ovaj račun 
	@param  (string)$args['url'] puni URL slike 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] za autentifikaciju 
	@return (bool)false prilikom neuspjeha, (string)userimage prilikom uspjeha 

grav.useUserimage - koristi korisničku sliku kao gravatar za jednu ili više adresa na ovom računu 
	@param  (string)$args['userimage'] Korisnička slika koju želite koristiti 
	@param  (array)$args['addresses'] Spisak email adresa na kojima želite da koristite ovu korisničku sliku 
	@param  (string)$args['password'] za autentifikaciju 
	@return array(
		address => (bool)status
	)

grav.removeImage - ukloni korisničku sliku povezanu sa jednom ili više email adresa 
	@param  (array)$args['addresses'] Spisak email adresa na kojima želite da koristite ovu korisničku sliku 
	@param  (string)$args['password'] za autentifikaciju 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - ukloni korisničku sliku sa računa i bilo koje email adrese s kojom je povezana 
	@param  (string)$args['userimage'] Korisnička slika koju želite da uklonite iz računa 
	@param  (string)$args['password'] za autentifikaciju 
	@return (bool)status

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