XML-RPC API
Connecting
التصديق
أخطاء
الطرق
النقطة النهائية لواجهة برمجة التطبيقات: https://secure.gravatar.com/xmlrpc?user=[email_hash]
من الضروري أن تقوم بالربط بـ secure.gravatar.com، وأن تقوم بذلك مع HTTPS. يتعلق هذا الأمر بسلامة مستخدمينا المشتركين. يُعد معيار email_hash GET دالة تجزئة md5 الخاصة بعناوين البريد الإلكتروني للمستخدمين بعد أن تم تصغير حروفها واقتطاعها.
ينبغي تمرير جميع المعايير الخاصة بجميع الطرق كعنصر واحد، ضمن مصفوفة مقترنة.
من الضروري أن تقوم بالربط بـ secure.gravatar.com، وأن تقوم بذلك مع HTTPS. يتعلق هذا الأمر بسلامة مستخدمينا المشتركين. يُعد معيار email_hash GET دالة تجزئة md5 الخاصة بعناوين البريد الإلكتروني للمستخدمين بعد أن تم تصغير حروفها واقتطاعها.
ينبغي تمرير جميع المعايير الخاصة بجميع الطرق كعنصر واحد، ضمن مصفوفة مقترنة.
التصديق
تحدث مصادقة المستخدم على مستوى طريقة واجهة برمجة التطبيقات. ستنتقل إلى طريقة استدعاء معيار كلمة المرور. سيتم تمرير بيانات هذه المعايير في نص عادي. يتم دائمًا تخطيط معيار كلمة المرور من الوسيطات قبل أن تبدأ الطرق بمعالجتها. لهذا السبب، ينبغي أن تتوقع عدم رؤيتها مرتجعة من طريقة grav.test.
أخطاء
يصاحب الأخطاء عادةً رقم ونص يمكن للأشخاص قراءته. بشكل عام، ينبغي متابعة النص كلما أمكن ذلك، ولكن الوصف الموجز لأكواد الخطأ الرقمية يكون كما يأتي:
-7 استعمل secure.gravatar.com -8 خطأ داخلي -9 خطأ في التصديق -10 معيار الطريقة مفقود -11 معيار الطريقة غير صحيح -100 خطأ متنوع (اطلع على النص)
الطرق
grav.exists - التحقُّق مما إذا كانت التجزئة تحتوي على جرافتار @param (array)$args['hashes'] مصفوفات التجزئة المراد التحقُّق منها @param (string)$args['password'] للتصديق @return array ( hash => (bool)exists, ) grav.addresses - إحصل على لائحة للعناوين لهذا الحساب @param (string)$args['password'] للتصديق @return array ( address => array ( rating => (int)rating, userimage => (int)userimage, userimage_url => (int)userimage_url ) ) grav.userimages - إرجاع مصفوفة من صور المستخدم الخاصة بهذا الحساب @param (string)$args['password'] للتصديق @return array ( userimage => array( (int)rating, // 0:g, 1:pg, 2:r, 3:x (string)url, ) ) grav.saveData - حفظ بيانات الصورة الثنائية كصورة مستخدم لهذا الحساب @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'] للتصديق @return (bool)false عند الفشل, (string)userimage عند النجاح grav.saveUrl - قراءة صورة من خلال عنوان URL الخاص بها وحفظ ذلك كصورة مستخدم لهذا الحساب @param (string)$args['url'] عنوان كامل لصورة @param (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x @param (string)$args['password'] للتصديق @return (bool)false عند الفشل, (string)userimage عند النجاح grav.useUserimage - استخدام صورة المستخدم كجرافتار لأحد العناوين أو أكثر الموجودة على هذا الحساب @param (string)$args['userimage'] صورة المستخدم التي ترغب في استخدامها @param (array)$args['addresses'] قائمة بعناوين البريد الإلكتروني التي ترغب في استخدام صورة المستخدم هذه لها @param (string)$args['password'] للتصديق @return array( address => (bool)status ) grav.removeImage - إزالة صورة المستخدم المرتبطة بأحد عناوين البريد الإلكتروني أو أكثر @param (array)$args['addresses'] قائمة بعناوين البريد الإلكتروني التي ترغب في استخدام صورة المستخدم هذه لها @param (string)$args['password'] للتصديق @return array( address => (bool)status ) grav.deleteUserimage - إزالة صورة مستخدم من الحساب وأي عناوين بريد إلكتروني مرتبطة به @param (string)$args['userimage'] صورة المستخدم التي ترغب في إزالتها من الحساب @param (string)$args['password'] للتصديق @return (bool)status grav.test - a test function @param (string)$args['password'] للتصديق @return (mixed)$args