XML-RPC API
Connecting
Hitelesítés
Hibák
Metódusok
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.
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