API XML-RPC
Connecting
Autentificare
Erori
Metode
Punct-final API: https://secure.gravatar.com/xmlrpc?user=[email_hash]
Este obligatoriu să te conectezi la secure.gravatar.com și să faci acest lucru prin HTTPS. Este pentru siguranța utilizatorilor noștri comuni. Parametrul email_hash GET este hașul md5 al adresei de email a utilizatorilor după ce a fost convertit în minuscule și dichisit.
Toți parametrii pentru toate metodele ar trebui să fie trecuți ca un element singular, într-un tablou asociativ.
Este obligatoriu să te conectezi la secure.gravatar.com și să faci acest lucru prin HTTPS. Este pentru siguranța utilizatorilor noștri comuni. Parametrul email_hash GET este hașul md5 al adresei de email a utilizatorilor după ce a fost convertit în minuscule și dichisit.
Toți parametrii pentru toate metodele ar trebui să fie trecuți ca un element singular, într-un tablou asociativ.
Autentificare
Autentificarea utilizatorului se face la nivelul metodei api. Vei trece la metoda apelare un parametru de parolă. Datele pentru acești parametri vor fi trecute în text simplu. Parametrul parolei este întotdeauna dezgolit de argumente înainte ca metodele să înceapă prelucrarea lor. Din acest motiv, trebuie să te aștepți să nu vezi că s-a întors de la metoda grav.test.
Erori
De obicei, erorile vin cu un număr și un text care poate fi citit de oameni. În general, textul ar trebui să fie urmărit ori de câte ori este posibil, dar există și o scurtă descriere a codurilor de eroare numerice după cum urmează:
-7 Folosește secure.gravatar.com -8 Eroare internă -9 Eroare la autentificare -10 Parametru metodă lipsă -11 Parametru metodă incorect -100 Erori diverse (vezi text)
Metode
grav.exists - verifică dacă un haș are un gravatar @param (array)$args['hashes'] un tablou de hașuri de verificat @param (string)$args['password'] pentru autentificare @return array ( hash => (bool)exists, ) grav.addresses - obții o listă de adrese pentru acest cont @param (string)$args['password'] pentru autentificare @return array ( address => array ( rating => (int)rating, userimage => (int)userimage, userimage_url => (int)userimage_url ) ) grav.userimages - returnează un tablou de imagini de utilizator pentru acest cont @param (string)$args['password'] pentru autentificare @return array ( userimage => array( (int)rating, // 0:g, 1:pg, 2:r, 3:x (string)url, ) ) grav.saveData - Salvează datele binare ale imaginii ca o imagine de utilizator pentru acest cont @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'] pentru autentificare @return (bool)false cu eșec, (string)userimage cu succes grav.saveUrl - Citește o imagine via URL-ul său și o salvează ca o imagine de utilizator pentru acest cont @param (string)$args['url'] un URL întreg la o imagine @param (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x @param (string)$args['password'] pentru autentificare @return (bool)false cu eșec, (string)userimage cu succes grav.useUserimage - folosește o imagine de utilizator ca gravatar pentru una din mai multe adrese din acest cont @param (string)$args['userimage'] Imaginea de utilizator pe care vrei s-o folosești @param (array)$args['addresses'] O listă de adrese de email pentru care vrei să folosești această imagine de utilizator @param (string)$args['password'] pentru autentificare @return array( address => (bool)status ) grav.removeImage - înlătură imaginea de utilizator asociată cu una sau mai multe adrese de email @param (array)$args['addresses'] O listă de adrese de email pentru care vrei să folosești această imagine de utilizator @param (string)$args['password'] pentru autentificare @return array( address => (bool)status ) grav.deleteUserimage - înlătură o imagine de utilizator din cont și toate adrese de email cu care este asociată @param (string)$args['userimage'] Imaginea de utilizator pe care vrei s-o înlături din cont @param (string)$args['password'] pentru autentificare @return (bool)status grav.test - a test function @param (string)$args['password'] pentru autentificare @return (mixed)$args