راهنمای برنامه نویسان و توسعه دهندگان

API فایل سل مورد استفاده برنامه نویسان و توسعه دهندگان نرم افزار است که قصد دارند روی نرم افزار خود امکان لایسنس و فعالسازی ایجاد کنند و با استفاده از فروشگاه فایل سل فروش نرم افزار و فعالسازی ان را اتوماتیک انجام دهند.


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

کدفعالسازی به چه صورت عمل می کند؟

سناریو فروش نرم افزار تا نصب و فعالسازی به این شکل خواهد بود شما نرم افزار را به عنوان یک محصول در فروشگاه اختصاصی خودتان در فایل سل برای فروش میگذارید و مشتری پس از خرید نرم افزار می تواند آن را دانلود کند علاوه بر این فایل سل به هر خریدار یک عدد 9 رقمی به عنوان کدفعالسازی می دهد که شما در نرم افزار خود این عدد را چک می کنید و اگر صحیح بود نرم افزار را نصب یا فعال می کنید.

← از کجا شروع کنیم ؟

ابتدا باید حساب کاربری در فایل سل داشته باشید اگر ثبت نام نکرده اید هم اکنون در فایل سل ثبت نام کنید (برای راهنمای ثبت نام اینجا کلیک کنید.) و ضمن ایجاد فروشگاه رایگان نرم افزار خود را به عنوان یک محصول در فروشگاه ایجاد و اماده فروش کنید
سپس لازم است حساب کاربری عادی خود را به حساب کاربری ویژه توسعه دهندگان تغییر دهید این کار ساده و رایگان است کافیست اینجا کلیک کنید  و در قسمت تنظیمات پیشرفته تیک حساب توسعه دهندگان را بزنید و ذخیره کنید
فعال کردن حساب توسعه دهندگان
سپس لازم است محصولی که برای نرم افزار خود ایجاد کردید را ویرایش کنید و در مشخصات نرم افزار دو گزینه جدید را مشاهده می کنید 1- تیک ارائه کدلایسنس یا کدفعالسازی به هر خریدار 2- مشخصات API مربوط به آن محصول که با زدن تیک تولید کدفعالسازی به محض خرید این محصول توسط مشتری یک عدد 9 رقمی به عنوان کدفعالسازی به مشتری داده میشود که با زدن این کد داخل نرم افزار شما میتواند نرم افزار را نصب یا فعال کند
فعال کردن تولید کدفعالسازی روی محصول
سپس لازم است با انجام دو مرحله فوق مشتری با خرید محصول شما یک کدفعالسازی دریافت می کند که لازم هست در برنامه خود فرمی در نظر بگیرید تا به نحوه دلخواه نصب یا فعالسازی نرم افزارتان را با سرور فایل سل چک کنید که در ادامه نحوه اتصال به سرور فایل سل و چک کردن صحت کدفعالسازی توضیح داده شده است و به راحتی می توانید برنامه خود را به سرور فایل سل متصل کنید.

نحوه چک کردن صحت کدفعالسازی

ما تمام تلاش خود را کردیم که بررسی صحت کدفعالسازی به راحتترین شکل برای شما امکان پذیر باشد بررسی صحت کدفعالسازی توسط چهار پارامتر زیر انجام میشود این نکته را در نظر بگیرید که بررسی صحت کدفعالسازی را با هربار اجرا برنامه انجام ندهید چون ممکن است کاربر نرم افزار شما همیشه به اینترنت متصل نباشد.

  • uid این مقدار در صفحه ویرایش محصول ذکر شده است
  • prod_id این مقدار در صفحه ویرایش محصول ذکر شده است
  • license مقداری که مشتری برای فعالسازی ارائه کرده است
  • update درصورتیکه مایل هستید شمارنده استفاده لایسنس غیرفعال شود مقدار no بزارید

ارسال چهار پارامتر فوق به آدرس زیر با method post باعث پاسخگویی به پرسش شما در مورد صحت کدفعالسازی میشود
http://filesell.ir/api/verify.php
پاسخ درصورت درست بودن پارامتر ها و صحیح بودن کدفعالسازی مشابه مقدار زیر است فرمت json:

{
"status":"true",
"uses":"2",
"info":{
	"order_id":"1200",
	"price":"5000",
	"email":"test@test.com",
	"tel":"0911223344",
	"date":"2014-10-29 01:20"
	}
}

مقدار uses در پاسخ تعداد دفعات استعلام شما برای کدفعالسازی را نشان میدهد و باهربار استعلام مقدار ان یک عدد اضافه می شود که درصورت تمایل میتوانید براساس ان متوجه استفاده از کدفعالسازی تکراری بشوید.
درصورتیکه کدفعالسازی اشتباه باشد مقدار زیر پاسخ داده میشود

{"status":"false"}

دقت کنید درصورتیکه مقدار uid یا prod_id اشتباه باشد پیام خطا مناسب دریافت خواهید کرد.

{"status":"false","text":"uid not set"}

نمونه کدهای برنامه نویسی

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

مثال Curl:
curl http://filesell.ir/api/verify.php
  \ -d "uid=5001"
  \ -d "prod_id=123456"
  \ -d "license=123456789"
  \ -d "update=no"
  \ -X POST

مثال PHP:
$url = 'http://filesell.ir/api/verify.php';
$fields = array('prod_id'=>3,'uid'=>5000,'update'=>'no','license'=>'987656432');
$ch = curl_init($url);
$fields_string = "";
foreach($fields as $key=>$value) { $fields_string .= $key.'='.$value.'&'; }
rtrim($fields_string,'&');
$ch = curl_init($url);
curl_setopt($ch,CURLOPT_URL,$url);
curl_setopt($ch,CURLOPT_POST,count($fields));
curl_setopt($ch,CURLOPT_POSTFIELDS,$fields_string);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);	
$result = curl_exec($ch);
curl_close($ch);
echo $result;
$result2=json_decode($result);
echo "status:$result2[status]";