بررسی اشتراک فعال

در این مطلب در مورد متد دریافت اشتراک فعال در سرویس اشتراک بازار صحبت خواهیم کرد. در صورت رخ دادن هرگونه مشکل می‌توانید با تماس با شماره تلفن ۰۲۱۹۱۰۰۹۷۹۸ مشکلات خود را با پشتیبانی توسعه دهندگان بازار در میان بگذارید.

متد دریافت اشتراک فعال

برای بررسی وضعیت اشتراک فعال کاربر در سرویس اشتراک بازار از این متد استفاده کنید:

https://pardakht.cafebazaar.ir/devapi/v2/api/applications/<package_name>/active-subscriptions/<token>/

مقادیر داخل پرانتز شکسته – <> – باید با توجه به درخواست جایگزین شوند:

نام	مقدار
package_name	نام بسته‌ای که اشتراک برای آن تعریف شده‌است.
token	token یکی از خرید‌های کاربر

توجه کنید که برای استفاده از این متد به access_token معتبر نیاز دارید. نتیجه موفق این درخواست، در قالب JSON و به شکل زیر خواهد بود:

{"subscriptions": 
[{
"kind": "androidpublisher#subscriptionPurchase", 
"initiationTimestampMsec": 1649788805381, 
"validUntilTimestampMsec": 1649875205381, 
"autoRenewing": true, 
"linkedSubscriptionToken": "subscription_token", 
"sku": "product_sku"
}]}

محتوای فیلدهای بازگشتی

محتوای فیلدهای پاسخ به این قرار است:

نام	مقدار
kind	نوع منبع مورد دسترسی. مقدار آن در این متد همیشه برابر androidpublisher#subscriptionPurchase است.
initiationTimestampMsec	زمان شروع اشتراک بر حسب میلی‌ثانیه از مبدا ۱۹۷۰/۱/۱ میلادی.
validUntilTimestampMsec	زمان پایان اشتراک بر حسب میلی‌ثانیه از مبدا ۱۹۷۰/۱/۱ میلادی.برای اشتراک‌هایی که به صورت خودکار تمدید می‌شوند این مقدار در زمان تمدید، آپدیت خواهد شد.
autoRenewing	مقداری boolean که مشخص می‌کند تمدید خودکار اشتراک فعال است یا خیر.
linkedSubscriptionToken	توکن اشتراک
sku	شناسه اشتراک فعال برای کاربر

در صورتی که به هر دلیل، درخواست معتبر نباشد، پاسخی با کد وضعیت 40X و در قالب JSON دریافت خواهید کرد که دارای یک کلید error با محتوای خطای ایجاد شده‌ و کلید error_desciption با شرحی بیشتر درباره خطا است. به عنوان مثال در صورتی که اشتراک موردنظر یافت نشود، پاسخ بازگشتی با کد وضعیت 404 و به صورت زیر خواهد بود:

{
   "error": "not_found",
   "error_description": "no subscription found!",
}

توجه: تنها اگر Error برابر با مقدار not_found باشد، کاربر، اشتراک فعالی در زمان دریافت درخواست نداشته است. به دلیل اختلاف زمان بین درخواست تا پاسخ، نتیجه موفق درخواست لزوما به معنای فعال بودن اشتراک نیست. برای اطمینان از فعال بودن اشتراک مقدار validUntilTimestampMsec را با زمان فعلی مقایسه کنید.

در جدول زیر خطاهای ممکن به همراه توضیحات آمده است:

reason	status code	error_description	error
مقدار package_name معتبر نیست.	404	Package name is invalid	invalid_value
کاربر اشتراک فعال ندارد.	404	no subscription found!	not_found
مقدار توکن معتبر نیست.	404	token not found!	not_found

---