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

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]";