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

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

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

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

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

ابتدا باید حساب کاربری در فایل سل داشته باشید اگر ثبت نام نکرده اید هم اکنون در فایل سل ثبت نام کنید و ضمن ایجاد فروشگاه نرم افزار خود را به عنوان یک محصول در فروشگاه ایجاد و اماده فروش کنید
سپس لازم است حساب کاربری عادی خود را به حساب کاربری ویژه توسعه دهندگان تغییر دهید این کار ساده و رایگان است کافیست اینجا کلیک کنید و در قسمت تنظیمات پیشرفته تیک حساب توسعه دهندگان را بزنید و ذخیره کنید

سپس لازم است محصولی که برای نرم افزار خود ایجاد کردید را ویرایش کنید و در مشخصات نرم افزار دو گزینه جدید را مشاهده می کنید 1- تیک ارائه کدلایسنس یا کدفعالسازی به هر خریدار 2- مشخصات API مربوط به آن محصول که با زدن تیک تولید کدفعالسازی به محض خرید این محصول توسط مشتری یک عدد 9 رقمی به عنوان کدفعالسازی به مشتری داده میشود که با زدن این کد داخل نرم افزار شما میتواند نرم افزار را نصب یا فعال کند

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

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

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

• uid این مقدار در صفحه ویرایش محصول ذکر شده است
• prod_id این مقدار در صفحه ویرایش محصول ذکر شده است
• license مقداری که مشتری برای فعالسازی ارائه کرده است
• update درصورتیکه مایل هستید شمارنده استفاده لایسنس غیرفعال شود مقدار no بزارید
• value این پارامتر دلخواه است و میتوانید مقداری برای ان نفرستید درصورتیکه برای آن مقداری ارسال کنید در اولین فراخوانی این مقدار در فایل سل ذخیره میشود و در فراخوانی های بعدی با مقدار ذخیره شده مقایسه می شود اگر یکسان بود مقدار status صحیح true خواهد شد در غیر اینصورت false خواهد بود از این پارامتر برای ذخیره مثلا سریال ماشین کاربری که نرم افزار را نصب کرده می توانید استفاده کنید تا در نصب های بعدی فقط روی همان دستگاه استفاده شود این پارامتر مقدار حروف انگلیسی a-z , A-Z , 0-9 را فقط قبول می کند.

ارسال چهار پارامتر فوق به آدرس زیر با 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]";

پروژه آماده AutoPlay Media Studio:
 دانلود پروژه