وبسرویس پیام کوتاه قاصدک، یک سرویس ارسال و دریافت پیام کوتاه از طریق REST API برای ارسال پیامکهای وبسرویسی است.
تلاش قاصدک روی این سرویس بر ارائهی خدمات با کیفیت، قابل اتکا و ساده به کاربرانش هست. در این قسمت راهنمای ساده برای ارسال و دریافت پیامک از طریق کتابخونه قاصدک برای laravel آماده کردیم.
کتابخونه ghasedak رو به سادگی می توانید از روی composer نصب کنید :
composer require ghasedaksms/ghasedaksms-laravel
برای استفاده از این پکیج میبایست API key داشته باشید. جهت دریافت ابتدا در سایت قاصدک ثبتنام کنید و از پنل کاربریتان API key دریافت کنید. متغیر زیر را درون فایل .env پروژهی خود کپی کرده و به جای your_api_key کلید دریافتی از حساب قاصدک خود را قرار دهید.
GHASEDAK_SMS_API_KEY=your_api_key
سپس می توانید به سادگی پیام خود را به شماره مورد نظر ارسال کنید :
php artisan make:notification SendOtpToUser
namespace App\Notifications;
use Carbon\Carbon;
use Ghasedak\DataTransferObjects\Request\InputDTO;
use Ghasedak\DataTransferObjects\Request\ReceptorDTO;
use Ghasedaksms\GhasedaksmsLaravel\Message\GhasedaksmsVerifyLookUp;
use Ghasedaksms\GhasedaksmsLaravel\Notification\GhasedaksmsBaseNotification;
use Illuminate\Bus\Queueable;
class SendOtpToUser extends GhasedaksmsBaseNotification
{
use Queueable;
public function __construct()
{
//
}
public function toGhasedaksms($notifiable): GhasedaksmsVerifyLookUp
{
$message = new GhasedaksmsVerifyLookUp();
$message->setSendDate(Carbon::now());
$message->setReceptors([new ReceptorDTO($notifiable->mobile, 'client referenceId')]);
$message->setTemplateName('newOTP');
$message->setInputs([new InputDTO('code', '******')]);
return $message;
}
}
تو این مثال تنها نیاز دارید که مقادیر مورد نظر خود را تغییر بدید.
با استفاده از این کتابخونه می توانید از عملیات های مختلفی مثل ارسال پیامکهای ساده، ارسال پیامک otp، ارسال پیامک گروهی و سایر خدمات قاصدک استفاده کنید. برای اینکار می توانید به صفحهی کتابخونه روی گیت هاب سری بزنید و البته مستندات وبسرویس قاصدک هم می تواند راه استفاده از قاصدک برای زبان های برنامه نویسی مختلف رو برای شما ساده تر نماید.
Ghasedak sms webservice package for laravel
The easiest way to install by using Composer:
composer require ghasedaksms/ghasedaksms-laravel
To use the package, you need an API key. To get that you should have a Ghasedak account. Register and get your API key.
Copy the following variable into your project's .env file and change your_api_key to the key you have got from your Ghasedak account.
GHASEDAK_SMS_API_KEY=your_api_key
$api = new GhasedakApi(env('GHASEDAKAPI_KEY'));
$api->Verify(
"09xxxxxxxxx", // receptor
1, // 1 for text message and 2 for voice message
"my-template", // name of the template which you've created in you account
"param1", // parameters (supporting up to 10 parameters)
"param2",
"param3"
);
$api = new GhasedakApi(env('GHASEDAKAPI_KEY'));
$api->SendSimple(
"09xxxxxxxxx", // receptor
"Hello World!", // message
"3000xxxxx" // choose a line number from your account
);