XML-RPC API

← Back

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

Είναι απαραίτητο να συνδεθείτε στο secure.gravatar.com μέσω HTTPS για λόγους ασφαλείας. Η παραμέτρος email_hash GET είναι το md5 hash από το email του χρήστη με πεζά γράμματα και αφού έχει γίνει trimmed.

Όλες οι παράμετροι για όλες τις μεθόδους πρέπει να περνάνε ως single item, μέσω πίνακα.

Authentication
Η ταυτοποίηση των λογαριασμών πραγματοποιείται σε επίπεδο μεθόδων API. Θα χρειαστεί να δημιουργήσετε μια παράμετρο για τον κωδικό χρήσης και να την περάσετε στην κλήση μεθόδου. Τα δεδομένα για αυτές τις παραμέτρους είναι απλό κείμενο. Η παράμετρος για τον κωδικό χρήσης απομακρύνεται πάντα πριν από την επεξεργασία των μεθόδων. Για αυτό τον λόγο δεν θα δείτε να εμφανίζεται κωδικός όταν χρησιμοποιείτε την μέθοδο grav.test.

Σφάλμα
Τα σφάλματα συνήθως συνοδεύονται από κάποιο αναγνωριστικό κείμενο. Γενικά το κείμενο πρέπει, όταν είναι εφικτό, να συνοδεύεται από μια σύντομη αναφορά στο error code όπως:

	-7	Χρήση του secure.gravatar.com 
	-8	Σφάλμα 
	-9	Authentication error 
	-10	Method parameter missing 
	-11	Method parameter incorrect 
	-100	Σφάλμα 

Μέθοδοι
grav.exists - ελέγξτε αν το hash έχει gravatar 
	@param  (array)$args['hashes'] πίνακας με hashes για έλεγχο 
	@param	(string)$args['password'] για authentication 
	@return array ( 
		hash => (bool)exists,
	)

grav.addresses - get a list of addresses for this account 
	@param  (string)$args['password'] για authentication 
	@return array ( 
		address => array (
			rating        => (int)rating, 
			userimage     => (int)userimage, 
			userimage_url => (int)userimage_url
		) 
	)

grav.userimages - επιστρέφει έναν πίνακα εικόνων για τον λογαριασμό 
	@param  (string)$args['password'] για authentication 
	@return array (
		userimage => array( 
			(int)rating, // 0:g, 1:pg, 2:r, 3:x
			(string)url,
		)
	) 

grav.saveData - Save binary image data as a userimage for this account 
	@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'] για authentication 
	@return (bool)false σε περίπτωση αποτυχίας, (string)userimage αν όλα πάνε καλά 

grav.saveUrl - Χρησιμοποίησε την φωτογραφία του URL ως την φωτογραφία αυτού του λογαριασμού 
	@param  (string)$args['url'] url για την φωτογραφία 
	@param  (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x
	@param  (string)$args['password'] για authentication 
	@return (bool)false σε περίπτωση αποτυχίας, (string)userimage αν όλα πάνε καλά 

grav.useUserimage - χρήση φωτογραφίας ως gravatar σε ένα η περισσότερα emails αυτού του λογαριασμού 
	@param  (string)$args['userimage'] Η φωτογραφία που θέλετε 
	@param  (array)$args['addresses'] Διευθύνσεις email για χρήση με αυτή την φωτογραφία 
	@param  (string)$args['password'] για authentication 
	@return array(
		address => (bool)status
	)

grav.removeImage - αφαίρεση φωτογραφίας από ένα ή περισσότερα emails 
	@param  (array)$args['addresses'] Διευθύνσεις email για χρήση με αυτή την φωτογραφία 
	@param  (string)$args['password'] για authentication 
	@return array(
		address => (bool)status
	)

grav.deleteUserimage - αφαίρεση φωτογραφίας από τον λογαριασμό και από όποιο email συσχετίζεται 
	@param  (string)$args['userimage'] Η φωτογραφία που θέλετε να αφαιρεθεί από τον λογαριασμό σας 
	@param  (string)$args['password'] για authentication 
	@return (bool)status

grav.test - a test function
	@param  (string)$args['password'] για authentication 
	@return (mixed)$args