XML-RPC API

← Back

Connecting
API paskirties taškas: https://secure.gravatar.com/xmlrpc?user=[email_hash]

Būtina jungtis per secure.gravatar.com ir būtinai turite naudoti HTTPS. To reikia mūsų bendriems naudotojams. email_hash GET parametra tai yra naudotojų el. pašto adresų md5 maišos kodas.

Visi visų metodų parametrai turi būti perduoti vienu elementu, susiesatame masyve.

Tapatybės nustatymas
Naudotojo tapatybės nustatymas vyksta api metodo lygyje. Jūs perduosite metodo iškvietimą slaptažodžio parametrui. Šie duomenys bus perduoti grynu tekstu. Prieš apdorojimą slaptažodžio parametras visada pašalinamas. Todėl grav.test metodo rezultate neturėtumėte jo matyti.

Klaidos
Paprastai klaidos pateikiamos žmogui suprantamu formatu. Visur kur įmanoma turėtų būti pateikiamas tekstas, bet štai trumpas skaitinių klaidų kodų aprašymas:

	-7	Naudoti secure.gravatar.com 
	-8	Vidinė klaida 
	-9	Tapatybės nustatymo klaida 
	-10	Trūksta metodo parametro 
	-11	Metodo parametras netinkamas 
	-100	Kita klaida (peržiūrėkite tekstą) 

Metodai
grav.exists - patikrinkite ar maišos kodas turi gravatarą 
	@param  (array)$args['hashes'] maišos kodų masyvo tikrinimas 
	@param	(string)$args['password'] tapatybės patvirtinimui 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - gaukite šios paskyros adresų sąrašą 
	@param  (string)$args['password'] tapatybės patvirtinimui 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - grąžinti šios paskyros naudotojo paveikslėlių masyvą 
	@param  (string)$args['password'] tapatybės patvirtinimui 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - Išsaugoti dvejetainius paveikslėlio duomenis kaip šios paskyros naudotojo paveikslėlį 
	@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'] tapatybės patvirtinimui 
	@return (bool)false nepavykus, (string)userimage pavykus 

grav.saveUrl - Skaityti paveikslėlį per jo URL ir išsaugoti kaip naudotojo paveikslėlį šiai paskyrai 
	@param  (string)$args['url'] pilnas adresas iki paveiklėlio 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] tapatybės patvirtinimui 
	@return (bool)false nepavykus, (string)userimage pavykus 

grav.useUserimage - naudoti naudotojo paveikslėlį kaip gravatarą vienam ar keliems šios paskyros adresams 
	@param  (string)$args['userimage'] Norimas naudoti naudotojo paveikslėlis 
	@param  (array)$args['addresses'] El. adresų sąrašas kuriems bus naudojamas šis naudotojo paveikslėlis 
	@param  (string)$args['password'] tapatybės patvirtinimui 
	@return array(
		address => (bool)status
	)

grav.removeImage - pašalinti naudotojo paveikslėlį susietą su vienu ar daugiau adresų 
	@param  (array)$args['addresses'] El. adresų sąrašas kuriems bus naudojamas šis naudotojo paveikslėlis 
	@param  (string)$args['password'] tapatybės patvirtinimui 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - pašalinti naudotojo paveikslėlį ir el. pašto adresą iš susietos paskyros 
	@param  (string)$args['userimage'] Naudotojo paveikslėlis kurį norite pašalinti 
	@param  (string)$args['password'] tapatybės patvirtinimui 
	@return (bool)status

grav.test - a test function
	@param  (string)$args['password'] tapatybės patvirtinimui 
	@return (mixed)$args