کاج تل | وب سرویس

وب سرویس

استفاده از وب سرویس فقط از آی پی های داخل ایران مقدور می باشد

وب سرویس کاج تل

وب سرویس ها برنامه (قطعه کد) هایی هستند که تحت وب قابل دسترسی اند و از طریق پروتکل های استانداردی مانند Http به انتقال و مبادله دیتا با سایر برنامه های کاربردی می پردازند. اساس کار وب سرویس (Web Service) ها بر پایه دریافت و تولید پیغام بنیان گذاری شده است. بدین معنی که آنها منتظر می مانند که کلاینت ها به آنها وصل شده و بنا به درخواست کلاینت ها به آن ها پاسخ می دهند . راه ارتباطی انتقال این پیغام ها یک آدرس است که شما میتوانید با افزودن آن در برنامه خود از خصوصیات آن استفاده نمائید

وب Api کاج تل

مخفف چیست؟ API به معنی رابط کاربردی برنامه نویسی یا Application Programming Interface و همچنین جنبه اساسی تشکیل وب 2 است. اما واقعا API چیست؟ ما در این مطلب به توضیح این موضوع خواهیم پرداخت. این کلمه توجه خاصی به رابط یا Interface دارد. اگر شما هر گونه تجربه ای در برنامه نویسی داشته باشید، همه معانی و مخفف ها با شنیدن کلمه Interface به ذهنتان می آید؛ اما ما بیشتر علاقمند به دانستن معنی کلاسیک و معمولی آن هستیم. یک رابط (Interface) یک مرز مشترک بین دو سیستم و سرویس جدا است. از جمله می توان این موضوع را برداشت کرد که بین این دو سیستم ارتباط برقرار است.

شما در اینجا چه از وب سرویس استفاده نمائید و چه از وب Api متدهایی که میتوانید از آن استفاده نمائید یکسان هستند ، شما میتوانید متدها را با توضیحات کامل به علاوه ی ورودی ها و خروجی های آن مشاهده نمائید:
برای راحتی کار شما در پایان توضیحات هر متد نمونه کدهایی از زبان های رایج نیز برایتان فراهم شده است.

خطاهای کلی

خروجی ها

مقدار خروجی	عنوان خروجی	شرح خروجی
-1	UserNotExists	نام کاربری یا رمز عبور اشتباه می باشد
-100	NotAllowWebService	دسترسی به وب سرویس غیرفعال میباشد
-101	MobileNotConfirm	احراز هویت انجام نشده است
-102	UserExpired	کاربری منقضی شده است
-20	UnknowError	خطای ناشناخته

MakeSecureCall از طریق این متد میتوان با دو شماره تلفن بدون مشخص بدون شماره آنها تماس برقرار کرد بیشتر بخوانید

ورودی ها

نام	نوع	شرح
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
srcNumber	String	شماره مبدا
dstNumber	String	شماره مقصد
holdMessageId	int	آیدی پیام جهت انتظار
serverId	int	کد سرور ارسال کننده پیام

خروجی ها

مقدار خروجی	عنوان خروجی
-1	نام کاربری یا رمزعبور صحیح نیست
-2	کد سرور صحیح نیست
-3	اعتبار کافی نیست، به ازای هر درخواست باید 1000 تومان اعتبار در حساب وجود داشته باشد
-4	کد پیام انتظار صحیح نیست
-5	عدم فعالسازی تماس امن
0	خطا در زیر ساخت

نکته: ورودی شماره ها، باید بدون صفر (0) باشد
برای مثال 9121111111

نمونه کدها

MakeSecureCall

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.MakeSecureCall(_Username, _Password, _srcNumber, _dstNumber, _holdMessageId,_serverId).ToString();
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

MakeSecureCall

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'srcNumber'=>'شماره تلفن مبدا',
        'dstNumber'=>'شماره تلفن مورد نظر',
        'holdMessageId'=>آیدی پیام جهت انتظار,
        'serverid'=>کد سرور ارسال کننده پیام
    );
    try{
        $res=$client->MakeSecureCall($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

UploadMessage از طریق این متد میتوانید فایل صوتی خود را که در قالب wav با فرمت PCM 8000h 16k mono تنظیم کرده اید، در سامانه آپلود و در ارسال ها استفاده نمایید.

ورودی ها

نام	نوع	شرح
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
Title	String	عنوان فایل صوتی شما
File	Byte[ ] dicbinaryfile	فایل صوتی شما که میبایست با پسوند wav و به صورت آرایه ای از نوع بایت باشد فایل صوتی شما میبایست در قالب mono,8000Hz,16b بوده و حجم آن نیز از 5مگابایت بیشتر نباشد

خروجی ها

مقدار خروجی	عنوان خروجی
-1	اعتبارسنجی
-10	فرمت نامناسب
-20	خطای ناشناخته
-30	اشکال در آپلود
بزرگتر از صفر	آی دی پیام آپلود شده

نمونه کدها

UploadMessage

var webservice = new kajtel.WebService3();
OpenFileDialog openFileDialog1 = new OpenFileDialog();
try
{
    openFileDialog1.InitialDirectory = "c:\\";
    openFileDialog1.Filter = "wav files (*.wav)|*.wav|All files (*.*)|*.*";
    openFileDialog1.RestoreDirectory = true;
    if (openFileDialog1.ShowDialog() == DialogResult.OK)
    {
        Byte[] bytes = System.IO.File.ReadAllBytes(openFileDialog1.FileName);
        textBox2.Text = webservice.UploadMessage(_Username, _Password, textBox1.Text, bytes).ToString();
    }
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

UploadMessage

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $data = file_get_contents("آدرس فایل wav");
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'title'=>'عنوان پیام',
        'file'=> $data
    );
    try{
        $res=$client->UploadMessage($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

DownloadMessage با استفاده از این شما میتوانید به فایل های آپلود شده در پنل دسترسی داشته باشید.

ورودی ها

نام	نوع	شرح
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
messageId	int	کد فایل صوتی

خروجی ها

مقدار خروجی	عنوان خروجی
null	اعتبارسنجی و یا عدم وجود فایل

نمونه کدها

DownloadMessage

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.DownloadMessage(_Username, _Password, Convert.ToInt32(textBox1.Text)).ToString();
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

DownloadMessage

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'messageId'=>'آی دی پیام'
    );
    try{
        $res=$client->DownloadMessage($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

DeleteMessage از طریق این متد می توانید فایل آپلود شده در سامانه را حذف نمایید.

ورودی ها

نام	نوع	شرح
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
messageId	int	کد [id] فایل آپلود شده

خروجی ها

مقدار خروجی	عنوان خروجی
false	اعتبارسنجی یا عدم وجود فایل
true	انجام موفقیت آمیز

نمونه کدها

DeleteMessage

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.DeleteMessage(_Username, _Password, Convert.ToInt32(textBox1.Text)).ToString();
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

DeleteMessage

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'messageId'=>'آی دی پیام'
    );
    try{
        $res=$client->DeleteMessage($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

CreateCampaign از طریق این متد میتوانید یک لیست ارسال ایجاد و در صورت تمایل ارسال نمایید

ورودی ها

نام	نوع	شرح
userName	string	متن ساده
password	string	متن ساده
title	string	عنوان لیست ارسال
numbers	string	شماره های لیست ارسال. شمارها باید با کما “,” از هم جدا شوند
maxTryCount	int	حداکثر تعداد تلاش برای هر شماره
minuteBetweenTries	int	مدت تاخیر بین تلاش ها بر اسا دقیقه
startDate	string	2116-11- تاریخ شروع ارسال لیست به میلادی. مانند: 11
startTime	string	ساعت شروع ارسال لیست. مانند: 18:11
endDate	string	2116-11- تاریخ خاتمه ارسال لیست به میلادی. مانند: 11
endTime	string	ساعت خاتمه ارسال لیست. مانند: 18:11
messageId	int	کد [id] پیام صوتی آپلود شده در سامانه
removeInvalids	bool	حذف شماره های اشتباه و تکراری بصورت خودکار
autoStart	bool	شروع خودکار لیست پس از ایجاد
vote	bool	فعال سازی امکان نظرسنجی بر روی تماس ها
serverid	int	کد سرور ارسال کننده پیام

خروجی ها

مقدار خروجی	عنوان خروجی
-1	اعتبارسنجی
-7	سرور آیدی اشتباه است یا وجود ندارد
-30	لیست ارسال وجود ندارد
-50	کمبود اعتبار
-60	کد پیام ناصحیح
-70	اطلاعات لیست ارسال صحیح نیست
بزرگتر از صفر	کد لیست ایجاد شده

نکته: serverid پارامتر جدیدی است که برای انتخاب شماره ارسال کننده پیام(سرور) گذاشته شده است.
شما میتوانید برای ارسال پیام های خود یکی از گزینه های زیر را انتخاب کنید:

ارسال از مشهد	عدد 1
ارسال از مازندران	عدد 15
ارسال از تهران شمال	20
ارسال از تهران جنوب	25
ارسال از تهران شرق	30
ارسال از تهران غرب	35
ارسال از خراسان شمالی	40

نمونه کدها

CreateCampaign

var webservice = new kajtel.WebService3();
try
{
    txtResult.Text = webservice.CreateCampaign(_Username, _Password,
        txtTitle.Text,
        txtNumbers.Text,
        Convert.ToInt32(ddlMaxTryCount.Text),
        Convert.ToInt32(ddlMinuteBetweenTry.Text),
        dtpStartDate.Value.Date.ToShortDateString(),
        txtStartTime.Text,
        dtpEndDate.Value.Date.ToShortDateString(),
        txtEndTime.Text,
        Convert.ToInt32(ddlMessages.SelectedValue),
        cbRemoveInvalids.Checked,
        cbStart.Checked,
        serverid.text,
        cbVote.Checked).ToString();

}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

CreateCampaign

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'campaignId'=>'آی دی کمپین',
        'title'=>'عنوان لیست ارسال',
        'numbers'=>'شماره های لیست ارسال',
        'maxtrycount'=>'حداکثر تعداد تلاش',
        'minutebetweentries'=>'مدت تاخیر بین هر تلاش',
        'startdate'=>'تاریخ شروع',
        'starttime'=>'ساعت شروع',
        'enddate'=>'تاریخ پایان',
        'endtime'=>'ساعت پایان',
        'messageId'=>'آی دی پیام',
        'removeInvalids'=>'حذف شماره تکراری و اشتباه',
        'autoStart'=>'شروع خودکار',
        'vote'=>'نظرسنجی',
        'serverid'=>کد سرور ارسال کننده پیام
    );
    try{
        $res=$client->CreateCampaign($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

StartCampaign Method از طریق این متد می توانید اقدام به ارسال یک لیست ارسال ایجاد شده نمایید.

ورودی ها

نام	نوع	شرح
username	string	متن ساده
password	string	string
campaignid	int	کد [id] لیست ارسال موردنظر
title	string	عنوان لیست ارسال
maxtrycount	int	حداکثر تعداد تلاش برای هر شماره
minutebetweentries	int	مدت تاخیر بین تلاش ها بر اسا دقیقه
startdate	string	2116-11- تاریخ شروع ارسال لیست به میلادی. مانند: 11
starttime	string	ساعت شروع ارسال لیست. مانند: 18:11
enddate	string	2116-11- تاریخ خاتمه ارسال لیست به میلادی. مانند: 11
endtime	string	ساعت خاتمه ارسال لیست. مانند: 18:11
serverid	int	کد سرور ارسال کننده پیام

خروجی ها

مقدار خروجی	عنوان خروجی
-1	اعتبارسنجی
-7	سرور آیدی اشتباه است یا وجود ندارد
-20	لیست ارسال وجود ندارد یا در وضعیت در حال ارسال است
-30	لیست ارسال وجود ندارد
-50	اعتبار کافی نیست
بزرگتر از صفر	کد لیست ایجاد شده

ارسال از مشهد	عدد 1
ارسال از مازندران	عدد 15
ارسال از تهران شمال	20
ارسال از تهران جنوب	25
ارسال از تهران شرق	30
ارسال از تهران غرب	35
ارسال از خراسان شمالی	40

نمونه کدها

StartCampaign

var webservice = new kajtel.WebService3();
try
{
    txtResult.Text = webservice.StartCampaign(_Username, _Password,
       _campaignId,
       _Title,
       _maxTryCount,
        _minuteBetweenTrys,
       _startDate,
       _startTime,
        _endDate,
       _endTime,
        _serverid
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

StartCampaign

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'campaignId'=>'آی دی کمپین',
        'title'=>'عنوان لیست ارسال',
        'maxtrycount'=>'حداکثر تعداد تلاش',
        'minutebetweentries'=>'مدت تاخیر بین هر تلاش',
        'startdate'=>'تاریخ شروع',
        'starttime'=>'ساعت شروع',
        'enddate'=>'تاریخ پایان',
        'endtime'=>'ساعت پایان',
        'serverid'=>کد سرور ارسال کننده پیام
    );
    try{
        $res=$client->StartCampaign($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

StopCampaign از طریق این متد می توانید اقدام به توقف یک لیست ارسال ایجاد شده و درحال ارسال نمایید.

ورودی ها

نام	نوع	شرح
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
campaignId	int	کد [id] لیست ارسال موردنظر

خروجی ها

مقدار خروجی	عنوان خروجی
false	اعتبارسنجی یا عدم وجود لیست ارسال
true	انجام موفقیت آمیز

نمونه کدها

StopCampaign

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.StopCampaign(_Username, _Password, Convert.ToInt32(textBox1.Text)).ToString();
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

StopCampaign

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'campaignId'=>'آی دی کمپین'
    );
    try{
        $res=$client->StopCampaign($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetCampaignByDateمــــتد دریافت نام و شماره شناسایی کاربــر

ورودی ها

نام	نوع	شرح
username	string	متن ساده
password	string	متن ساده
fromdate	string	2116-11- تاریخ شروع به میلادی. مانند: 11
todate	string	2116-11- تاریخ پایان به میلادی. مانند: 11

خروجی ها

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

نمونه کدها

GetCampaignsByDate

var webservice = new kajtel.WebService3();
try
{
    dataGridView1.DataSource = webservice.GetCampaignsByDate(_Username, _Password, dateTimePicker1.Value.ToShortDateString(), dateTimePicker2.Value.ToShortDateString());
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetCampaignsByDate

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'fromDate'=>'تاریخ شروع',
        'toDate'=>'تاریخ پایان'

    );
    try{
        $res=$client->GetCampaignsByDate($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetCampaignById از طریق این متد می توانید اطلاعات یک لیست های ایجاد شده را بر اساس کد [id] لیست دریافت نمایید.

ورودی ها

نام	نوع	شرح
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
campaignId	Int	کد [id] لیست ارسال

خروجی ها

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

مقدار خروجی	عنوان خروجی
8	عدم تائید
9	در انتظار
10	تائید شده
11	در حال ارسال
12	تمام شده
27	متوقف شده

نمونه کدها

GetCampaignById

var webservice = new kajtel.WebService3();
try
{
    var model = webservice.GetCampaignById(_Username, _Password, Convert.ToInt32(textBox1.Text));
    var datatable = new DataTable();
    datatable.Columns.Add("property");
    datatable.Columns.Add("value");
    foreach (PropertyInfo propertyInfo in model.GetType().GetProperties())
    {
        var dr = datatable.NewRow();
        dr["property"] = propertyInfo.Name;
        dr["value"] = propertyInfo.GetValue(model, null);
        datatable.Rows.Add(dr);
    }
    dataGridView1.DataSource = datatable;
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetCampaignById

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'campaignId'=>'آی دی کمپین'

    );
    try{
        $res=$client->GetCampaignById($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetCampaignNumbersByCampaignId از طریق این متد می توانید اطلاعات شماره های داخل یک لیست ارسال را بر اساس کد [id] لیست دریافت نمایید.

ورودی ها

نام	نوع	شرح
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
campaignId	Int	کد [id] لیست ارسال

خروجی ها

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

خروجی ها

مقدار خروجی	عنوان خروجی
3	موفق
6	عدم پاسخ
7	مشغولی
4	عدم دسترسی

نمونه کدها

GetCampaignNumbersByCampaignId

var webservice = new kajtel.WebService3();
try
{
    dataGridView1.DataSource = webservice.GetCampaignNumbersByCampaignId(_Username, _Password, Convert.ToInt32(textBox1.Text));
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetCampaignNumbersByCampaignId

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'campaignId'=>'آی دی کمپین'

    );
    try{
        $res=$client->GetCampaignNumbersByCampaignId($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

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

ورودی ها

نام	نوع	شرح
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
fromDate	string	2116-11- تاریخ شروع به میلادی. مانند: 11
toDate	string	2116-11- تاریخ پایان به میلادی. مانند: 11

خروجی ها

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

نمونه کدها

GetCampaignNumbersBySendDate

var webservice = new kajtel.WebService3();
try
{
    dataGridView1.DataSource = webservice.GetCampaignNumbersBySendDate(_Username, _Password, _fromDate,_ToDate);
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

پی اچ پی

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'fromDate'=>'تاریخ شروع',
        'fromDate'=>'تاریخ پایان'
    );
    try{
        $res=$client->GetCampaignNumbersBySendDate($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetCampaignNumbersDataByIds از طریق این متد می توانید با ارسال رشته ای از کد های شماره )جدا شده توسط کاما “,” (، اطلاعات آنها را در قالب یک لیست دریافت نمایید

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
campaignNumberIds	string	رشته ای از کد های شماره )جدا شده توسط کاما “,” ) .

خروجی ها

نمونه کدها

GetCampaignNumbersDataByIds

var webservice = new kajtel.WebService3();
try
{
    dataGridView1.DataSource = webservice.GetCampaignNumbersDataByIds(_Username, _Password, textBox1.Text);
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetCampaignNumbersDataByIds

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'campaignNumberIds'=>'آی دی کمپین های مورد نظر شما'
    );
    try{
        $res=$client->GetCampaignNumbersDataByIds($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetCampaignNumberStatusById از طریق این متد می توانید وضعیت ارسال یک شماره خاص را دریافت نمایید

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
campaignNumberId	int	کد [id] شماره

خروجی ها

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

مقدار خروجی	عنوان خروجی
-3	ارسال شده
-2	در انتظار
-1	موفق
0	عدم دسترسی
1,3	عدم پاسخ
5,8	مشغولی

نمونه کدها

GetCampaignNumberStatusById

var webservice = new kajtel.WebService3();
try
{
    var model = webservice.GetCampaignNumberStatusById(_Username, _Password, Convert.ToInt32(textBox1.Text));
    var datatable = new DataTable();
    datatable.Columns.Add("property");
    datatable.Columns.Add("value");
    foreach (PropertyInfo propertyInfo in model.GetType().GetProperties())
    {
        var dr = datatable.NewRow();
        dr["property"] = propertyInfo.Name;
        dr["value"] = propertyInfo.GetValue(model, null);
        datatable.Rows.Add(dr);
    }
    dataGridView1.DataSource = datatable;
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetCampaignNumberStatusById

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'campaignNumberId'=>'آی دی کمپین مورد نظر شما'
    );
    try{
        $res=$client->GetCampaignNumberStatusById($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetCampaignNumbersStatusByIds از طریق این متد می توانید با ارسال رشته ای از کد های شماره )جدا شده توسط کاما “,” (، وضعیت آنها را در قالب یک لیست دریافت نمایید

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
campaignNumberIds	string	رشته ای از کد های شماره )جدا شده توسط کاما “,” ) .

خروجی ها

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

مقدار خروجی	عنوان خروجی
-3	ارسال شده
-2	در انتظار
-1	موفق
0	عدم دسترسی
1,3	عدم پاسخ
5,8	مشغولی
null	اعتبارسنجی
-10	تعداد بیشتر از 100
-20	خطای ناشناخته

نمونه کدها

GetCampaignNumbersStatusByIds

var webservice = new kajtel.WebService3();
try
{
    var model = webservice.GetCampaignNumbersStatusByIds(_Username, _Password, textBox1.Text);
    string result = "";
    foreach (var item in model)
    {
        result = item.ToString() + ",";
    }
    textBox2.Text = result;
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetCampaignNumbersStatusByIds

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'campaignNumberIds'=>'آی دی کمپین های مورد نظر شما'
    );
    try{
        $res=$client->GetCampaignNumbersStatusByIds($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GenerateTTS استفاده از سرویس آواخوان جهت تولید پیام صوتی

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
Speaker	string	انتخاب گوینده - male برای گوینده اقا - female برای گوینده خانم
your Text	string	متن مورد نظر شما جهت تبدیل شدن به صوت
title	string	عنوان فایل صوتی

خروجی ها

مقدار خروجی	عنوان خروجی
-1	اعتبارسنجی
-2	اشکال در آپلود
-3	کمبود اعتبار
-4	عدم اتصال به TTS
-5	تعداد کاراکتر بیش از 1000 است
بزرگتر از صفر	آی دی پیام آپلود شده

نمونه کدها

GenerateTTS

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.GenerateTTS(_Username, _Password,_ChooseSpeaker,_YourText,true or false);
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

GenerateTTS

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'speaker'=>'انتخاب گوینده',
        'text'=>'متن مورد نظر شما',
        'title'=>'عنوان فایل صوتی'
    );
    try{
        $res=$client->GenerateTTS($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

QuickSendWithTTS استفاده از سرویس ویژه آواخوان

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
Text	text	متن مورد نظر شما جهت تبدیل شدن به صوت
number	string	شماره تماس
vote	bool	فعال سازی نظرسنجی بر روی ارسال
serverid	int	کد سرور برای ارسال پیام

ارسال از مشهد	عدد 1
ارسال از مازندران	عدد 15
ارسال از تهران شمال	20
ارسال از تهران جنوب	25
ارسال از تهران شرق	30
ارسال از تهران غرب	35
ارسال از خراسان شمالی	40

خروجی ها

مقدار خروجی	عنوان خروجی
0	کاربر دمو است
-1	اعتبارسنجی
-7	سرور آیدی اشتباه است یا وجود ندارد
-2	اشکال در آپلود
-3	کمبود اعتبار
-4	عدم اتصال به TTS
-5	تعداد کاراکتر بیشتر از 1000 است
-6	خارج از محدوده زمانی ارسال است
بزرگتر از صفر	آی دی پیام آپلود شده

نمونه کدها

QuickSendWithTTS

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.QuickSendWithTTS(_Username, _Password,_Text, _number, _Vote,_serverid).ToString();
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

QuickSendWithTTS

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'text'=>'متن مورد نظر شما',
        'number'=>'شماره تلفن مورد نظر',
        'vote'=>false,
        'serverid'=>کد سرور ارسال کننده پیام
    );
    try{
        $res=$client->QuickSendWithTTS($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

SendOTP ارسال کد اعتبار سنجی . بیشتر بخوانید

تذکر: تعداد کد ارسالی برای کاربر توسط OTP دارای محدودیت 4 تا 8 رقمی است . برای استفاده از حالات دیگر میتوانید همین سیستم را با استفاده از سرویس آوخوان پیاده سازی کنید.

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

ورودی ها

نام	نوع	توضیحات
userName	String	نام کاربری شما در سامانه کاج تل
password	String	رمز عبور شما در سامانه کاج تل
Length	int	طول کد ( حداقل 4 و حداکثر 8)
number	string	شماره تماس
text	string	کد امنیتی شما :...
serverid	id	کد سرور ارسال کننده پیام صوتی

خروجی ها

مقدار خروجی	عنوان خروجی
-1	مشکل در اعتبارسنجی
-7	سرور آیدی اشتباه است یا وجود ندارد
-2	اشکال در آپلود
-3	کمبود اعتبار
-4	عدم اتصال به TTS
-5	تعداد کاراکتر بیشتر از 1000 است
-6	خارج از محدوده زمانی ارسال است
بزرگتر از صفر	یک کد با طول تعیین شده به صورت تصادفی

ارسال از مشهد	عدد 1
ارسال از مازندران	عدد 15
ارسال از تهران شمال	20
ارسال از تهران جنوب	25
ارسال از تهران شرق	30
ارسال از تهران غرب	35
ارسال از خراسان شمالی	40

نمونه کدها

SendOTP

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.SendOTP(_userName, _password,_lenght, _number,_serverid).ToString();
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'Length'=>'طول کد ارسالی',
        'number'=>'شماره تلفن مورد نظر',
        'text'=>'پر کردن این فیلد اجباری است',
        'serverid'=>کد سرور ارسال کننده پیام
    );
    try{
        $res=$client->SendOTP($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

SendOCV اعتبار سنجی با یک کلیک

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
number	string	شماره تماس
callbackUrl	string	آدرس برگشت برای دریافت عدد وارد شده توسط کاربر
serverid	int	کد سرور برای ارسال پیام

خروجی ها

مقدار خروجی	عنوان خروجی
-1	مشکل در اعتبارسنجی
-7	سرور آیدی اشتباه است یا وجود ندارد
-2	اشکال در آپلود
-3	کمبود اعتبار
-4	عدم اتصال به TTS
-5	تعداد کاراکتر بیشتر از 1000 است
-6	خارج از محدوده زمانی ارسال است
بزرگتر از صفر	یک کد با طول تعیین شده به صورت تصادفی

ارسال از مشهد	عدد 1
ارسال از مازندران	عدد 15
ارسال از تهران شمال	20
ارسال از تهران جنوب	25
ارسال از تهران شرق	30
ارسال از تهران غرب	35
ارسال از خراسان شمالی	40

نمونه کدها

SendOCV

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.SendOCV(_Username, _Password, _number,_callbackUrl,_serverid).ToString();
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'callbackUrl'=>'آدرس برگشت برای کد وارد شده کاربر',
        'number'=>'شماره تلفن مورد نظر',
        'serverid'=>کد سرور ارسال کننده پیام
    );
    try{
        $res=$client->SendOCV($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

QuickSend از طریق این متد می توانید برای یک شماره ارسال سریع انجام دهید.

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
messageId	id	کد [id] لیست پیام آپلود شده
number	string	شماره تماس
vote	bool	فعال سازی نظرسنجی بر روی ارسال
serverid	int	کد سرور برای ارسال پیام

خروجی ها

مقدار خروجی	عنوان خروجی
-1	اعتبارسنجی
-2	شماره وارد نشده است
-3	اعتبار کافی نیست
-6	خارج از محدوده زمانی ارسال
-7	سرور آیدی اشتباه است یا وجود ندارد
-8	ای دی صوت اشتباه است

ارسال از مشهد	عدد 1
ارسال از مازندران	عدد 15
ارسال از تهران شمال	20
ارسال از تهران جنوب	25
ارسال از تهران شرق	30
ارسال از تهران غرب	35
ارسال از خراسان شمالی	40

نمونه کدها

QuickSend

var webservice = new kajtel.WebService3();
try
{
    textBox2.Text = webservice.QuickSend(_Username, _Password, _messageId,_number, _Vote,_serverid).ToString();
}
catch (Exception ex)
{
    textBox2.Text = ex.Message;
}

QuickSend

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'messageId'=>'آی دی پیام مورد نظر',
        'number'=>'شماره تلفن مورد نظر',
        'vote'=>false,
        'serverid'=>کد سرور ارسال کننده پیام
    );
    try{
        $res=$client->QuickSend($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetQuickSend از طریق این متد می توانید اطلاعات یک ارسال سریع را بر اساس کد [id] آن دریافت نمایید.

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
quickSendId	id	کد [id] ارسال سریع
price	decimal	این پارامتر بصورت byref می باشد و پس از اجرای متد مقدار آن برابر با هزینه ارسال می باشد

خروجی ها

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

نمونه کدها

GetQuickSend

var webservice = new kajtel.WebService3();
try
{
    decimal price = 0;
    var model = webservice.GetQuickSend(_Username, _Password, Convert.ToInt32(textBox1.Text),ref price);
    var datatable = new DataTable();
    datatable.Columns.Add("property");
    datatable.Columns.Add("value");
    foreach (PropertyInfo propertyInfo in model.GetType().GetProperties())
    {
        var dr = datatable.NewRow();
        dr["property"] = propertyInfo.Name;
        dr["value"] = propertyInfo.GetValue(model, null);
        datatable.Rows.Add(dr);
    }
    dataGridView1.DataSource = datatable;
    textBox2.Text = price.ToString();
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetQuickSend

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'quickSendId'=>'آی دی پیام ارسال سریع',
        'price'=>'مبلغ به صورت بازگشتی'

    );
    try{
        $res=$client->GetQuickSend($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

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

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل
fromDate	string	2116-11- تاریخ شروع به میلادی. مانند: 11
toDate	string	2116-11- تاریخ پایان به میلادی. مانند: 11

خروجی ها

خروجی این متد از نوع عدد اعشاری برابر با مجموعه هزینه ارسال ها در بازه مشخص شده می باشد.

مقدار خروجی	عنوان خروجی
-1	اعتبارسنجی
بزرگتر از صفر	کل مبلغ

نمونه کدها

GetTotalCostByDate

var webservice = new kajtel.WebService3();
try
{
    textBox1.Text = webservice.GetTotalCostByDate(_Username, _Password, dateTimePicker1.Value.ToShortDateString(), dateTimePicker2.Value.ToShortDateString()).ToString();
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetTotalCostByDate

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما',
        'fromDate'=>'تاریخ شروع',
        'toDate'=>'تاریخ پایان'

    );
    try{
        $res=$client->GetTotalCostByDate($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetMessages از طریق این متد می توانید لیست کلیه پیام های آپلود شده در سامانه را دریافت نمایید.

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل

خروجی ها

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

نمونه کدها

GetMessages

var webservice = new kajtel.WebService3();
dataGridView1.DataSource = webservice.GetMessages(_Username, _Password);

GetMessages

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما'
    );
    try{
        $res=$client->GetMessages($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetCredit از طریق این متد می توانید اعتبارموجود پنل خود را دریافت نمایید

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل

خروجی ها

مقدار خروجی	عنوان خروجی
-1	اعتبارسنجی
بزرگتر از صفر	اعتبار موجود

نمونه کدها

GetCredit

var webservice = new kajtel.WebService3();
try
{
    textBox1.Text = webservice.GetCredit(_Username, _Password).ToString();
}
catch (Exception ex)
{
    textBox1.Text = ex.Message;
}

GetCredit

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما'
    );
    try{
        $res=$client->GetCredit($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetExpirationDate از طریق این متد می توانید تاریخ انقضا پنل را دریافت نمایید.

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل

خروجی ها

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

نمونه کدها

GetExpirationDate

var webservice = new kajtel.WebService3();
try
{
    textBox1.Text = webservice.GetExpirationDate(_Username, _Password).ToString();
}
catch (Exception ex)
{
    textBox1.Text = ex.Message;
}

GetExpirationDate

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما'

    );
    try{
        $res=$client->GetExpirationDate($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

GetPrices از طریق این متد می توانید تعرفه های پنل خود را دریافت نمایید

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل

خروجی ها

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

نمونه کدها

GetPrices

var webservice = new kajtel.WebService3();
try
{
    var model = webservice.GetPrices(_Username, _Password);
    var datatable = new DataTable();
    datatable.Columns.Add("property");
    datatable.Columns.Add("value");
    foreach (PropertyInfo propertyInfo in model.GetType().GetProperties())
    {
        var dr = datatable.NewRow();
        dr["property"] = propertyInfo.Name;
        dr["value"] = propertyInfo.GetValue(model, null);
        datatable.Rows.Add(dr);
    }
    dataGridView1.DataSource = datatable;
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message, "خطا", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

GetPrices

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما'
    );
    try{
        $res=$client->GetPrices($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

UserInfo از طریق این متد می توانیداطلاعات حساب کاربری خود را دریافت نمایید.

ورودی ها

نام	نوع	توضیحات
UserName	String	نام کاربری شما در سامانه کاج تل
Password	String	رمز عبور شما در سامانه کاج تل

خروجی ها

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

نمونه کدها

UserInfo

                                            var webservice = new kajtel.WebService3();
try
{
    textBox1.Text = webservice.UserInfo(_Username, _Password).ToString();
}
catch (Exception ex)
{
    textBox1.Text = ex.Message;
}

UserInfo

<?php
    date_default_timezone_set('Asia/tehran');
    $wsdl='http://<YourDomain> or <portal.kajtel.ir>/webservice3.asmx?WSDL';
    $client = new SoapClient($wsdl);
    $param=array(
        'userName'=>'نام کاربری شما',
        'password'=>'رمزعبور شما'
    );
    try{
        $res=$client->UserInfo($param)	;
        echo '<pre>' ;
        var_dump($res) ;
        echo '</pre>' ;
    }catch(Exception $e){
        echo '<pre>' ;
        var_dump($e->getMessage());
        echo '</pre>' ;
    }
?>

Login Function

        function login() {
            var username = $('#username').val();
            var password = $('#password').val();
            $.ajax({
                url: 'http://<YourDomain>/account/ajaxlogin/',
                data: { username: username, password: password },
                type: 'POST',
                success: function (data) {
                    if (data.result) {
                        window.location = 'http://<YourDomain>/account/tokenlogin/?username=' + username + '&token=' + data.token;
                    }
                    else {
                        var error = '';
                        $.each(data.message, function (index, item) {
                            error += item + ',';
                        })
                        alert(error);
                    }
                }
            })
        }

SignUp Function

        function signup() {
            var fullname = $('#FullName').val();
            var lastname = $('#LastName').val();
            var mobile = $('#Mobile').val();
            var username = $('#UserName').val();
            var password = $('#Password').val();
            var refby = $('#refby').val();
            var confirmPassword = $('#ConfirmPassword').val();
            $.ajax({
                url: 'http://<YourDomain>/account/ajaxregister/',
                data: { fullname: fullname, mobile: mobile, username: username, password: password, confirmPassword: confirmPassword, refby: refby },
                type: 'POST',
                success: function (data) {
                    console.log()
                    if (data.result) {
                        window.location = 'http://<YourDomain>/account/tokenlogin/?username=' + username + '&token=' + data.token;
                    }
                    else {
                        var error = '';
                        $.each(data.message, function (index, item) {
                            error += item + ',';
                        })
                        alert(error);
                    }
                }
            })
        }

resetPassword Function

        function resetPassword() {
            var username = $('#forget_username').val();
            var mobile = $('#forget_mobile').val();
            $.ajax({
                url: 'http://<YourDomain>/account/AjaxResetPassword/',
                data: { username: username, mobile: mobile },
                type: 'POST',
                beforeSend: function () {
                    $('#btnResetPassword').html('لطفا کمی صبر نمایید...');
                    $('#btnResetPassword').attr('disabled', 'disabled');
                },
                success: function (data) {
                    if (data.result) {
                        showLogin();
                    }
                    var error = '';
                    $.each(data.message, function (index, item) {
                        error += item + ',';
                    })
                    alert(error);
                },
                complete: function () {
                    $('#btnResetPassword').html('بازیابی رمزعبور');
                    $('#btnResetPassword').removeAttr('disabled');
                }
            })
        }

نمونه کد کامل استفاده از وب سرویس (همراه با ابزار تبدیل و ترکیب صوت) نمونه کد نوشته شده به زبان سی شارپ (Windows Form)

دانلود پروژه

حجم فایل : 3.23MB

زبان برنامه نویسی : C# WinForm - .Net 4.5

کلیه حقوق این سایت متعلق به اپراتور پیام صوتی کاج تل میباشد

شرکای تجاری شرکت توسعه ارتباط و خدمات طلائی خاورمیانه و شرکای تجاری شرکت مخابرات ایران

مجوز شماره 735/8420726 شرکت مخابرات ایران