کد ارسال و دریافت پیامک


کیت توسعه نرم‌افزار یا SDK ، مجموعه ای از توابع و کتابخانه‌های کامپایل شده‌ای است که برای آسان کردن برنامه‌نویسی در اختیار توسعه دهندگان قرار می‌ گیرد.
شرکت کاوه نگار بعد از انتشار وب سرویس اس ام اس REST و SOAP اقدام به تولید SDK برای زبان های برنامه نویسی محبوب نمود تا گسترش دهندگان نرم افزار بتوانند به راحتی با افزودن یک کتابخانه به پروژه خود از سرویس کاوه نگار در هر پروژه ها استفاده نمایند.

نکته کد ارسال پیامک کاوه نگار بر مبنای وب سرویس پیامک REST می باشد، بنابراین در صورت تمایل به دریافت جزئیات بیشتر می توانید به مستندات وب سرویس REST مراجعه نمائید.

توابع موجود در SDK شامل ارسال پیامک سریع ، ارسال پیامک گروهی ، دریافت وضعیت پیامک های ارسال ،ارسال کد اعتبارسنجی پیامک و تماس تلفنی، واکشی پیامک های دریافتی و گزارشات مربوط به میزان ارسال و دریافت پیامک می باشد .

برای ارائه مشکلات و یا پیشنهادات خود در رابطه با SDK می توانید از طریق ایمیل support@kavenegar.com آن را به ما منتقل کنید و یا از طریق یک Push Request در کانال گیت هاب ما را مطلع نمائید .

در صورتی که در گیت هاب حساب کاربری دارید خوشحال میشویم کاوه نگار را دنبال نمائید.


کد ارسال و دریافت پیامک در سی شارپ و VB.NET


برای استفاده از SDK کاوه نگار در زبان های دات نت کافی است فایل DLL دانلود شده را به بخش Refrence های پروژه اضافه نمایید.

نکته : در صورتی که در اجرای هر کدام از متدها مشکلی وجود داشته باشد ، یک Exception ارسال می شود ، که شما می توانید با استفاده از آن خطا موجود را شناسایی کنید.
ApiException : به این معنی است که ارتباط با وب سرویس امکان پذیر بوده و خطایی از آن دریافت کرده است ( لیست خطاها به همراه توضیحات )
HttpException : به این معنی است که مشکلی در برقراری ارتباط با سرویس کاوه نگار وجود دارد.


DotNET Framework v4.0 کتابخانه مورد نظر برای دات نت فریم ورک نسخه 4 به بالا

DotNET Framework v2.0 کتابخانه مورد نظر برای دات نت فریم ورک نسخه 2

دانلود نمونه کد نمونه کد ارسال پیامک مورد نظر شامل مثالی هایی برای ارسال ساده و گروهی و دریافت وضعیت و دریافت پیامک می باشد

ارسال پیامک در سی شارپ
try
{
	Kavenegar.KavenegarApi api = new Kavenegar.KavenegarApi("Your Api Key");
	var res = api.Send("3000123432", "09360462966", "خدمات پیام کوتاه کاوه نگار");
	foreach (SendResult r in ret1)
              {
	 Console.Write("r.Messageid.ToString()");  //Collect MessageId(s) and store them
              }
}
catch (Kavenegar.Exceptions.ApiException ex) 
{
	// در صورتی که خروجی وب سرویس 200 نباشد این خطارخ می دهد.
	Console.Write("Message : " + ex.Message);
}
catch (Kavenegar.Exceptions.HttpException ex) 
{
	// در زمانی که مشکلی در برقرای ارتباط با وب سرویس وجود داشته باشد این خطا رخ می دهد
	Console.Write("Message : " + ex.Message);
}

ارسال پیامک در VB.NET
Try
	Dim api As New Kavenegar.KavenegarApi("Your Api Key")
	Dim resut As Kavenegar.Models.SendResult = api.Send("3000324325", "09360462966", "خدمات پیام کوتاه کاوه نگار")
Catch ex As Kavenegar.Exceptions.ApiException
	// در صورتی که خروجی وب سرویس 200 نباشد این خطارخ می دهد.
	Console.WriteLine("Message : " & ex.Message)
Catch ex As Kavenegar.Exceptions.HttpCodeException
	// در زمانی که مشکلی در برقرای ارتباط با وب سرویس وجود داشته باشد این خطا رخ می دهد
	Console.WriteLine("Message : " & ex.Message)
End Try

کد ارسال پیامک درPHP


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

نکته : در صورتی که در اجرای هر کدام از متدها مشکلی وجود داشته باشد ، یک Exception ارسال می شود ، که شما می توانید با استفاده از آن خطا موجود را شناسایی کنید تا پیام مناسبی به کاربر نمایش دهید
ApiException : به این معنی است که ارتباط با وب سرویس امکان پذیر بوده ولی خطایی در احرای متد وجود داشته ( لیست خطاها به همراه توضیحات )
HttpException : به این معنی است که مشکلی در برقراری ارتباط با سرویس کاوه نگار وجود دارد.
شما به عنوان برنامه نویس و توسعه دهنده وظیفه قرار دادن کد مناسب با سیستم خود را در این کلاس دارید
برای مثال شما مایل هستید بعد از ایجاد خطا, متن و اطلاعات پشته خطا در فایلی ذخیره و سپس پیام مناسب به کلاینت نمایش داده شود.


دریافت PHP SDK دریافت نمونه کد PHP

ارسال پیامک در PHP
<?php

try
{	
	require("/Kavenegar/KavenegarApi.php");
	$api = new KavenegarApi(" { Your Api Key } ");
	$result = $api->send("30006703323323","09360462966","خدمات پیام کوتاه کاوه نگار");
	echo print_r($result);
}
catch(ApiException $ex)
{
	echo $e->errorMessage();
}
catch(HttpException $ex)
{
	echo $e->errorMessage();
}

?>

ارسال پیامک در Java


برای استفاده از SDK کاوه نگار در زبان جاوا یا پلتفرم Android کافی است که فایل jar را دانلود کرده و به بخش کتابخانه های پروژه اضافه کنید.

نکته : در صورتی که در اجرای هر کدام از متدها مشکلی وجود داشته باشد ، یک Exception ارسال می شود ، که شما می توانید با استفاده از آن خطا موجود را شناسایی کنید.
ApiException : به این معنی است که ارتباط با وب سرویس امکان پذیر بوده و خطایی از آن دریافت کرده است ( لیست خطاها به همراه توضیحات )
HttpException : به این معنی است که مشکلی در برقراری ارتباط با سرویس کاوه نگار وجود دارد.


دریافت Java SDK دریافت نمونه کد Java

ارسال پیامک در Java
try
{
	Kavenegar.KavenegarApi api = new Kavenegar.KavenegarApi("{ Your Api Key }");
	api.Send("3000123432", "09360462966", "خدمات پیام کوتاه کاوه نگار");
}
catch (Kavenegar.Exceptions.ApiException ex) 
{
	// در صورتی که خروجی وب سرویس 200 نباشد این خطارخ می دهد.
	System.out.print("Message : " + ex.Message);
}
catch (Kavenegar.Exceptions.HttpException ex) 
{
	// در زمانی که مشکلی در برقرای ارتباط با وب سرویس وجود داشته باشد این خطا رخ می دهد
	System.out.print("Message : " + ex.Message);
}

ارسال پیامک در Delphi


با توجه آنکه Parser ساختار Json در دلفی نسخه 2011 به بالا وجود دارد استفاده از SDK در نسخه های 2011 و بالاتر توصیه میشود در صورتی که شما از نسخه های پایین تر استفاده می کنید توصیه میشود از راهنمای SOAP استفاده نمایید.

ارسال پیامک در دلفی

برای استفاده از SDK کاوه نگار در زبان دلفی ، کافی است که فایل مورد نظر را را دانلود کرده و به بخش کتابخانه های پروژه اضافه کنید.

توجه : این نسخه از SDK برای دلفی 2011 و بالاتر مناسب می باشد , در صورتی که شما از نسخه های پائین تر استفاده می کنید
لطفا به صفحه راهنمای SOAP مراجعه نمائید تا نسخه مناسب با دلفی 6 و 7 را دریافت کنید.


دریافت Delphi SDK دریافت نمونه کد Delphi

کد ارسال پیامک در NodeJS


برای استفاده از وب سرویس کاوه نگار در NodeJS می توانید از نمونه کد استفاده نمائید.

کد ارسالSMS توسط اقای الیاس قاسمی نوشته شده است.


دانلود نمونه کد


کد ارسال پیامک درCURL


 curl -XPOST http://api.kavenegar.com/v1/{API-KEY}/sms/send.json \
	--data-urlencode "receptor=09121234567"  \
	--data-urlencode "sender=30006703323323"  \
	--data-urlencode "message=خدمات پیام کوتاه کاوه نگار"  \

کاوه نگار در Github

در صورتی که پیشنهاد و نظری در مورد تغییرات نمونه کد ها داشتید خوشحال میشویم از طریق Push Request گیت هاب مارا مطلع نمایید Kavenegar Github

^