وب سرویس پایش اعتبار اندروید ریور

معرفی وب سرویس ARAuth

برای ساده سازی بیشتر پیاده سازی api در پروژه های خود ، می توانید از پروژه نمونه وب سرویس اندروید ریور استفاده کنید. کافیست این اسکریپت نمونه را به پروژه های خود اضافه کنید.

دریافت از Github

نام : Android River Authentication (ARAuth)
ساختار : JavaScript Object Notation
سطح دانش مورد نیاز : پیشرفته
نسخه : BETA 1nov2020
توسعه دهنده : اندروید ریور

وب سرویس پایش اعتبار اندروید ریور یا به اختصار ARAuth بر پایه JSON توسعه داده شده است و برای پایش و راستی آزمایی خرید محصولات برای دست یافتن به داده هایی به کار می رود که گواهی راه اندازی پروژه را بر اساس داده های ارسالی کاربر به فروشنده می دهد. تا فروشنده محصول بتواند از نصب پروژه بیش از یک بار برای هر خرید جلوگیری کند.

تیم توسعه ما سعی کرده استفاده از این وب سرویس را با مستندات ساده شده آسان و قابل درک کند تا همه فروشندگان مارکت اندروید ریور بتوانند از آن در پروژه های خود استفاده کنند.البته شما می توانید با نوشتن اسکریپت یا کتابخانه جانبی بر اساس این وب سرویس و مستندات ساده شده با توجه به اینکه سطح پیشرفته ای از دانش برنامه نویسی را نیازمند است، به کاربران تازه کار کمک کنید.ما در صورت تایید اسکریپت یا کتابخانه جانبی شما آن را به صورت رسمی در حساب گیت هاب اندروید ریور منتشر می کنیم.

شروع #برگشت بالا

برای پایش اعتبار داده ها و احراز صحت اطلاعات وارد شده توسط کاربر می توانید به شیوه های زیر عمل کنید. ما در طراحی وب سرویس سعی کردیم ساده ترین راه را در اختیار شما قرار دهیم.

آدرس اعتبار سنجی

$url = "https://androidriver.net/auth/validate?email=[USER_EMAIL]&key=[LICENCE_KEY]&domain=[USER_DOMAIN]&id=[PRODUCT_ID]";

آدرس اعتبار سنجی برای استفاده در اندروید

$url = "https://androidriver.net/auth/validate?email=[USER_EMAIL]&key=[LICENCE_KEY]&id=[PRODUCT_ID]&android=true";

آدرس اصلی API اعتبار سنجی شامل چهار متغییر است که باید از کاربر دریافت کنید. توجه داشته باشید دریافت هر چهار متغییر از کاربر الزامی است. در ادامه درباره این سه متغییر توضیح داده خواهد شد.

نکته : در صورتی که قصد استفاده از API در سورس کد اندروید را داشته باشید پارامتر domain را می توانید با android=true جایگزین کنید.

این پارامتر ایمیل کاربر که با آن خرید انجام داده است می باشد

key

پارامتر کد لایسنس خرید است که در رسید خرید به کاربر نمایش داده می شود

domain

دامنه ای که کاربر برای نصب محصول ارائه داده است

این پارامتر شناسه مربوط به محصول خریداری شده است

android

برای استفاده از وب سرویس در سورس کد اندروید

اعتبار سنجی خرید #بازگشت به بالا

این مثال برای درک بهتر کار با متغییر های مورد نیاز وب سرویس است و برای اجرای آن نیاز به پیاده سازی یک متد برای وارد کردن اطلاعات از سمت خریدار هستید..
به عنوان نمونه : از طریق یک فرم اعتبار سنجی

اعتبار سنجی با استفاده از متغییر ها

برای سنجش اعتبار اطلاعات دریافتی از کاربر نیاز است از طریق آدرس API آن ها را از سرور پایش اعتبار ما بپرسید. بعد از ارسال درخواست پایش اعتبار ، سرور به درخواست شما در قالب یک فایل JSON پاسخ می دهد که شامل چهار شئ است که برای پایش اعتبار کاربر مورد استفاده قرار میگیرد.

به این نمونه کد توجه کنید :

// دامنه ای که از کاربر دریافت می کنید $user_domain = "androidriver.ir"; // آدرس وب سرویس پایشگر داده; $url = "https://androidriver.net/auth/validate?email=email@androidriver.ir&key=OzjQX45NoLME4RO2pK3vRki6yeKAdDvG"&id="$id."&domain=".$user_domain; // دریافت اطلاعات از وب سرویس و قراردادن آن در یک متغییر $json = file_get_contents($url); // استخراج داده های JSON $json = json_decode($json); // validation متغییر برای ذخیره اطلاعات شئ $valid = $json->validation; //اگر پایش اطلاعات به خوبی تکمیل شد if($valid == "true"){ echo "Is Vaild : " . $valid; // کد های دیگر خود را در ادامه بنویسید }else{ return false; }

4 شئ که می توانید با آنها کار کنید #بازگشت به بالا

validation
enable
domain
desc

1 . validation
این شئ در سه حالت مختلف به درخواست شما پاسخ می دهد این سه حالت عبارتند از : true false Not Found

بدیهی است مقدار true در زمانی که اطلاعات ارسالی با پاسخ مثبت و کاملا درست سرور مواجه شود به درخواست ارسال می شود. مقدار false در زمانی که بخشی از داده های پرسش شده از سرور اشتباه باشد برای کاربر ارسال می شود و مقدار Not Found در زمانی که کل اطلاعات ارسالی مخدوش باشند چاپ می شود.

2 . enable
این شئ در سه حالت مختلف به درخواست شما پاسخ می دهد این سه حالت عبارتند از : true false Not Found

3 . domain

$domain = 'androidriver.ir';
//اگر این شرایط برقرار باشد

این شئ در دو حالت مختلف به درخواست شما پاسخ می دهد این سه حالت عبارتند از : androidriver.ir null

مقدار $domain همواره چاپ می شود. در حالتی که داده ارسالی کاملا مخدوش باشد مقدار null برگشت داده می شود.

4 . desc
این شئ در سه حالت مختلف به درخواست شما پاسخ می دهد این سه حالت عبارتند از : لایسنس برای شما فعال است
لایسنس برای شما غیر فعال است لایسنس یافت نشد

پیغام این بخش به شئ های 1 و 2 بسیار وابسته است. درصورت صحیح بودن کل اطلاعات مقدار پیغام مبنی بر یافت شدن لایسنس ارسال می شود در زمانی که بخشی از اطلاعات مخدوش باشد لایسنس برای شما غیر فعال است برگردانده می شود و در زمانی که هیچ لایسنسی برای درخواست وجود نداشته باشد مقدار لایسنس یافت نشد برگشت داده می شود.