راهنما و مستندات api آواتار پروفایل
در مقاله قبل در مورد معرفی وب سرویس پروفایل صحبت کردیم این مقاله در مورد راهنما و مستندات وب سرویس آواتار پروفایل است
یکی از ماموریت‌های پروفایل ارائه بستری مناسب برای برنامه‌نویسان است تا بتوانند به اطلاعات کاربران و کسب و کارهای ثبت شده در این سرویس دسترسی داشته باشند. با کمک این سرویس کاربران ایرانی می‌توانند به‌صورت متمرکز اطلاعات خود را مدیریت کرده و هم‌چنین از سایر سرویس‌های ایرانی در ساده‌ترین حالت ممکن استفاده کنند.
افتخار داریم که سرویس آواتار را به عنوان اولین سرویس پروفایل برای برنامه‌نویسان معرفی کنیم. این سرویس شامل برتری‌هایی نسبت به Gravatar (نمونه خارجی سرویس پروفایل) است که از جمله آن می‌توان به موارد زیر اشاره کرد:
- امکان دسترسی به به‌روزترین تصاویر کاربران
- اتصال به سرویس Gravatar و هم‌چینین Google Plus جهت دریافت تصویر کاربرانی که در پروفایل عضویت ندارند.
- قابلیت درخواست تصویر افراد براساس شماره تماس
- سرعت بارگذاری بیشتر نسبت به سرویس Gravatar
- ارائه لینک حساب کاربری پروفایل افراد
ساختار درخواست اطلاعات کاربر
از سرویس آواتار پروفایل می‌توان در دو قالب متفاوت خروجی دریافت کرد.
- خروجی در قالب تصویر
سرویس دریافت مستقیم تصویر تنها برای آدرس ایمیل قابل استفاده است.
در این روش آدرس ایمیل کاربر می‌بایست به وسیله الگوریتم رمزنگاری یکطرفه MD5 رمزنگاری شود.
جهت دریافت مستقیم تصویر افراد، درخواست از سرویس پروفایل می‌تواند در قالب یکی از دو روش زیر ارسال شود:
https://avatar.profile.ir/avatar/{MD5_HASHED_EMAIL_ADDRESS}.jpg{?s=size}
https://avatar.profile.ir/avatar/{MD5_HASHED_EMAIL_ADDRESS}{?s=size}
ابعاد تصویر پروفایل
در سرویس آواتار پروفایل، تصاویر پروفایل افراد می‌تواند در ابعاد 40، 80، 200 و 400 پیکسل درخواست شود. در صورت مشخص نکردن مقدار size در درخواست ارسال شده، تصویر در اندازه پیش فرض خود 400 پیکسل برگشت داده خواهدشد.
- خروجی در قالب JSON
اگر بر اساس آدرس ایمیل رمزنگاری شده افراد به اطلاعات در قالب JSON نیاز دارید درخواست خود را در قالب زیر ارسال کنید:
https://avatar.profile.ir/{MD5_HASHED_EMAIL_ADDRESS}.json
خروجی JSON
{
“entry”: {
“hash”: “e913736f39838a341c526fbc28fed8dd”,
“mobile”: null,
“email”: null,
“profileUrl”: null,
“username”: null,
“thumbnailUrl”: “https://files.profile.ir/Thumbs/sample/sample.jpg”,
“displayName”: “sample User”
}
}
موارد profileUrl و username در صورتی مقداردهی می‌شوند که اطلاعات از وبسایت پروفایل گرفته شده باشند.
مزیت این روش نسبت به دریافت مستقیم تصویر پروفایل، امکان دسترسی به آدرس اینترنتی کاربر است. لطفا در نظر داشته باشید که این سرویس تنها به شبکه اجتماعی پروفایل و سرویس گراواتار متصل است. اگر مایل به دسترسی به تصویر افراد در سرویس گوگل هستید، پیشنهاد ما استفاده از API اصلی آواتار پروفایل است.
در این مطلب در مورد مستندات وب سرویس آواتار پروفایل صحبت کردیم در مطلب بعد در مورد راهنمای وب سرویس پروفایل توضیح میدهیم