XML-RPC API

← Back

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

Elengedhetetlen, a HTTPS protokollon keresztül csatlakozás a secure.gravatar.com webcímhez, amely biztonságos belépést nyújt a felhasználók számára. Az email_hash GET paraméter a felhasználók e-mail címét kódolja le MD5 hash formátumba.

Minden paramétert így minden módszert tovább kell adni egy asszociatív tömbön belül.

Hitelesítés
A felhasználói hitelesítés API metódus szinttel történik. A jelszó paraméter hívás módszert használ. Az adatok ezen a paramétereken keresztül kerülnek átadásra szöveges formában.

Hibák
A hibák általában egy hibakóddal, és egy ember által olvasható szöveggel jelennek meg. Általánosan a szövegnek mindig követnie kell a hibakódot, ahol lehet, de itt van egy rövid leírása a hibakódoknak:

	-7	secure.gravatar.com cím használata 
	-8	Belső hiba 
	-9	Hitelesítési hiba 
	-10	Metódus paraméter hiányzik 
	-11	Metódus paraméter nem megfelelő 
	-100	Egyéb hiba (lásd a szövegben) 

Metódusok
grav.exists - gravatar hash ellenőrzése 
	@param  (array)$args['hashes'] hash tömb ellenőrzése 
	@param	(string)$args['password'] Hitelesítés 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - Címlista ehhez a fiókhoz 
	@param  (string)$args['password'] Hitelesítés 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - vissza a fiókhoz 
	@param  (string)$args['password'] Hitelesítés 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - Bináris képadatok ehhez a fiókhoz 
	@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'] Hitelesítés 
	@return (bool)false hiba esetén, (string)userimage siker esetén 

grav.saveUrl - Olvassunk be egy képet a hivatkozása alapján, és mentsük el adatlapi képnek ehhez a fiókhoz. 
	@param  (string)$args['url'] egy teljes hivatkozás vagy kép 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] Hitelesítés 
	@return (bool)false hiba esetén, (string)userimage siker esetén 

grav.useUserimage - használj egy képet egy gravatar-ként egy vagy több címhez a fiókban 
	@param  (string)$args['userimage'] A használni kívánt kép 
	@param  (array)$args['addresses'] Azoknak az e-mail címeknek a listája, amihez szeretnéd használni ezt a képet 
	@param  (string)$args['password'] Hitelesítés 
	@return array(
		address => (bool)status
	)

grav.removeImage - kapcsolódó kép eltávolítása az e-mail cím(ek)ről 
	@param  (array)$args['addresses'] Azoknak az e-mail címeknek a listája, amihez szeretnéd használni ezt a képet 
	@param  (string)$args['password'] Hitelesítés 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - kép eltávolítása a fiókból és az e-mail címektől melyekhez hozzá van rendelve 
	@param  (string)$args['userimage'] Kép eltávolítása a fiókból 
	@param  (string)$args['password'] Hitelesítés 
	@return (bool)status

grav.test - a test function
	@param  (string)$args['password'] Hitelesítés 
	@return (mixed)$args