skeser/netgsm-sms

Netgsm Sms

维护者

详细信息

github.com/skeser/sms

源代码

安装: 0

依赖者: 0

建议者: 0

安全: 0

星星: 0

关注者: 0

分支: 4

类型：package

dev-main 2023-09-14 20:08 UTC

Requires

  • php: >=7.2.5

MIT 36a236a88a5fb13ce2305cba7041d23d5f85a58e

  • Netgsm <teknikdestek.woop@netgsm.com.tr>

This package is not auto-updated.

Last update: 2024-09-27 23:06:58 UTC

README

Netgsm Sms 是为拥有 paket aboneliği 的用户提供的 composer 包。

联系 & 支持

有关 Netgsm API 服务的问题和建议，请发送至 teknikdestek@netgsm.com.tr。

支持的 Laravel 版本

Laravel 6.x, Laravel 7.x, Laravel 8.x, Laravel 9.x, Laravel 10.x

支持的 Lumen 版本

Lumen 6.x, Lumen 7.x, Lumen 8.x, Lumen 9.x,

支持的 Symfony 版本

Symfony 4.x, Symfony 5.x, Symfony 6.x

支持的 Php 版本

PHP 7.2.5 及以上

文档

https://www.netgsm.com.tr/dokuman/ 提供了关于 API 服务的详细文档以及不同编程语言的示例代码。

安装

composer require netgsm/sms

.env 文件中必须定义 NETGSM ABONELİK 信息。

NETGSM_USERCODE=""
NETGSM_PASSWORD=""
NETGSM_HEADER=""

参数

1:n 短信发送

您可以通过 1:n 方法一次性向多个号码发送短信。

        use Netgsm\Sms\SmsSend;
        $data=array(
            'message'=>'test mesajı',
            'no'=>['553xxxxxxx','553xxxxxxx'],
            'header'=>'MESAJ_BASLİK',
            'filter'=>0,
            'encoding'=>'tr',
            'startdate'=>'170220231000',
            'stopdate'=>'170220231200',
            'bayikodu'=>'1312...',
            'appkey'=>'A123-F3DASD-XXXXX....'
        );
        $sms= new SmsSend;
        $cevap=$sms->smsGonder($data);
        dd($cevap);
        die;

成功请求示例

Array
(
    [code] => 00
    [bulkid] => 1311033503
    [durum] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
)

失败请求示例

Array
(
    [code] => 30
    [durum] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

n:n 短信发送

您可以在同一包中向不同的号码发送不同的短信内容。

        use Netgsm\Sms\SmsSend;
        $msGsm=array(
                    array('gsm'=>'553XXXXXX','message'=>'MESAJ METNİ 1'),
                    array('gsm'=>'553XXXXXX','message'=>'MESAJ METNİ 2')
                );
        $data=array('startdate'=>'170220231210','stopdate'=>'170220231300','header'=>'BASLIGINIZ','filter'=>0);
        $sms=new SmsSend;
        $cevap=$sms->smsGonderNN($msGsm,$data);
        dd($cevap);
        die;

成功请求示例

Array
(
    [code] => 00
    [bulkid] => 1311033503
    [durum] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
)

失败请求示例

Array
(
    [code] => 30
    [durum] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

单条短信发送

        use Netgsm\Sms\SmsSend;
        $sms=new SmsSend;
        $data=array(
            'msgheader'=>"",
            'gsm'=>'553XXXXXXX',
            'message'=>'Merhaba',
            'filter'=>'0',
            'startdate'=>'270120230950',
            'stopdate'=>'270120231030',
        );

        $sonuc=$sms->smsgonder1_1($data);
        dd($sonuc);
        die;

成功请求示例

Array
(
    [code] => 00
    [aciklama] => Görevinizin tarih formatinda bir hata olmadığını gösterir.
    [bulkid] => 1311044635
)

失败请求示例

Array
(
    [code] => 40
    [aciklama] => Mesaj başlığınızın (gönderici adınızın) sistemde tanımlı olmadığını ifade eder. Gönderici adlarınızı API ile sorgulayarak kontrol edebilirsiniz.
)

短信查询

通过查询发送的短信在过去 3 个月内的情况，可以了解短信的发送状态。

状态

        use Netgsm\Sms\SmsSend;
        $sms=new SmsSend;
        $data=array('bulkid'=>'1311042194','bastar'=>'010220231500','bittar'=>'070220231500','status'=>'100','type'=>2);
        //bulkid girildiğinde type 0 gönderilmelidir.type=0 girildiğinde bastar ve bittar girilmesine gerek bulunmamaktadır.
        //bastar ve bittar girildiğinde type 2 gönderilmelidir.
        $sonuc=$sms->smsSorgulama($data);
        dd($sonuc);
        die;

成功请求结果

Array
(
    [durum] => İletilmiş olanlar
    [durumcode] => 1
    [operator] => Türk Telekom
    [operatorcode] => 20
    [hataaciklama] => Hata Yok.
    [hatakod] => 0
    [cepno] => 905531105200
    [mesajboy] => 1
    [tarih] => 23.01.2023 09:35:00
)

失败请求结果

Array
(
    [code] => 60
    [aciklama] => Arama kriterlerinize göre listelenecek kayıt olmadığını ifade eder.
)

短信取消

您可以取消计划在将来发送的短信，或更改任务时间。

        $sms=new SmsSend;
        $data=array('bulkid'=>'1311176624','startdate'=>'180220230100','stopdate'=>'180220231000','type'=>1);
        //type=0 gönderilirse  startdate ve stopdate gönderilmesine gerek yoktur.
        //type=1 gönderilirse stardate ve stopdate değerleri güncellenebilir.
        $sonuc=$sms->smsiptal($data);
        dd($sonuc);
        die;

成功请求结果

Array
(
    [aciklama] => İleri zamanlı görevinizin başarılı bir şekilde iptal edilğini ifade eder.
    [code] => 00
)

失败请求结果

Array
(
    [aciklama] => Baslangiç ve bitis tarihleri arasindaki fark en az 1 , en fazla 21 saat olmalidir.
    [code] => 60
)

接收短信查询

您可以通过此服务查询订阅的包 - 活动。

        use Netgsm\Sms\SmsSend;	
        $islem=new SmsSend;
        $data=array('startdate'=>'120120230940','stopdate'=>'230120231400');
        $sonuc=$islem->gelensms($data);
        dd($sonuc);
        die;

成功请求示例结果

Array
(
    [0] => Array
        (
            [telno] => 553xxxxxxx 
            [mesaj] =>  mesaj_içerigi
            [tarih] =>  12.01.2023 09:43:51
        )

    [1] => Array
        (
            [telno] => 553xxxxxxx 
            [mesaj] =>  mesaj_içerigi
            [tarih] =>  12.01.2023 09:43:04
        )

)

失败请求示例结果

Array
(
    [code] => 60
    [aciklama] => Arama kiterlerindeki startdate ve stopdate zaman farkının 30 günden fazla olduğunu ifade eder.
)

标题(发送者名称)查询

这是一个查询您账户中定义的发送者名称（消息标题）的模块。

        use Netgsm\Sms\SmsSend;
        $baslik=new SmsSend;
        $sonuc=$baslik->basliksorgu();
        dd($sonuc);
        die;

成功请求示例结果

Array
(
    [msgheader] => Array
        (
            [0] => 850xxxxxxx
            [1] => HEADER_BILGISI
        )

)

失败请求示例结果

Array
(
    [code] => 30
    [error] => Kullanici bilgisi bulunamadi
)

黑名单

黑名单也称为 SMS 发送禁止号码列表，您可以使用添加到黑名单/从黑名单中删除模块添加或删除您指定的号码。黑名单中的号码将不会从您的账户发送短信。此检查由 Netgsm 提供。

        use Netgsm\Sms\SmsSend;
       	$karaliste=new SmsSend;
        $data=array('number'=>['553xxxxxxx','553xxxxxxx'],'tip'=>2);
        $sonuc=$karaliste->karaliste($data);
        dd($sonuc);
        die;

成功请求示例结果

Array
(
    [code] => OK
    [aciklama] => Kara Listeye Ekleme / Çıkarma işleminde bir hata olmadığını gösterir.
)

失败请求示例结果

Array
(
    [code] => 60
    [aciklama] => Geçersiz tip gönderimi
)

闪信

您的短信将在用户的手机屏幕上以通知的形式显示。
订阅号码必须是企业号码。

        use Netgsm\Sms\SmsSend;
       	$data=array('message'=>'Test','gsm'=>['553xxxxxxx','553xxxxxxx'],
                    'header'=>'312xxxxxxx',
                    'encoding'=>'tr',
                    'startdate'=>'170220231418',
                    'stopdate'=>'170220231425',
                    'filter'=>0,
                    'bayikodu'=>132,
                    'appkey'=>'hsfxa-xhytf21-....',
        );
        $islem=new SmsSend;
        $sonuc=$islem->flashSms($data);
        dd($sonuc);
        die;

成功请求示例结果

Array
(
    [aciklama] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
    [code] => 00
    [bulkid] => 1311191776
)

失败请求示例结果

Array
(
    [code] => 30
    [aciklama] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

=======

Laravel & Symfony Netgsm Sms 集成

Netgsm Sms 是为拥有 paket aboneliği 的用户提供的 composer 包。

目录

支持

有关 Netgsm API 服务的问题和建议，请发送至 teknikdestek@netgsm.com.tr。

支持的 Laravel 版本

Laravel 6.x, Laravel 7.x, Laravel 8.x, Laravel 9.x, Laravel 10.x

支持的 Lumen 版本

Lumen 6.x, Lumen 7.x, Lumen 8.x, Lumen 9.x,

支持的 Symfony 版本

Symfony 4.x, Symfony 5.x, Symfony 6.x

支持的 Php 版本

PHP 7.2.5 及以上

文档

https://www.netgsm.com.tr/dokuman/ 提供了关于 API 服务的详细文档以及不同编程语言的示例代码。

安装

composer require netgsm/sms

.env 文件中必须定义 NETGSM ABONELİK 信息。

NETGSM_USERCODE=""
NETGSM_PASSWORD=""
NETGSM_HEADER=""

参数

1:n 短信发送

您可以通过 1:n 方法一次性向多个号码发送短信。

        use Netgsm\Sms\SmsSend;
        $data=array(
            'message'=>'test mesajı',
            'no'=>['553xxxxxxx','553xxxxxxx'],
            'header'=>'MESAJ_BASLİK',
            'filter'=>0,
            'encoding'=>'tr',
            'startdate'=>'170220231000',
            'stopdate'=>'170220231200',
            'bayikodu'=>'1312...',
            'appkey'=>'A123-F3DASD-XXXXX....'
        );
        $sms= new SmsSend;
        $cevap=$sms->smsGonder($data);
        dd($cevap);
        die;

成功请求示例

Array
(
    [code] => 00
    [bulkid] => 1311033503
    [durum] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
)

失败请求示例

Array
(
    [code] => 30
    [durum] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

n:n 短信发送

您可以在同一包中向不同的号码发送不同的短信内容。

        use Netgsm\Sms\SmsSend;
        $msGsm=array(
                    array('gsm'=>'553XXXXXX','message'=>'MESAJ METNİ 1'),
                    array('gsm'=>'553XXXXXX','message'=>'MESAJ METNİ 2')
                );
        $data=array('startdate'=>'170220231210','stopdate'=>'170220231300','header'=>'BASLIGINIZ','filter'=>0);
        $sms=new SmsSend;
        $cevap=$sms->smsGonderNN($msGsm,$data);
        dd($cevap);
        die;

成功请求示例

Array
(
    [code] => 00
    [bulkid] => 1311033503
    [durum] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
)

失败请求示例

Array
(
    [code] => 30
    [durum] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

单条短信发送

        use Netgsm\Sms\SmsSend;
        $sms=new SmsSend;
        $data=array(
            'msgheader'=>"",
            'gsm'=>'553XXXXXXX',
            'message'=>'Merhaba',
            'filter'=>'0',
            'startdate'=>'270120230950',
            'stopdate'=>'270120231030',
        );

        $sonuc=$sms->smsgonder1_1($data);
        dd($sonuc);
        die;

成功请求示例

Array
(
    [code] => 00
    [aciklama] => Görevinizin tarih formatinda bir hata olmadığını gösterir.
    [bulkid] => 1311044635
)

失败请求示例

Array
(
    [code] => 40
    [aciklama] => Mesaj başlığınızın (gönderici adınızın) sistemde tanımlı olmadığını ifade eder. Gönderici adlarınızı API ile sorgulayarak kontrol edebilirsiniz.
)

短信查询

通过查询发送的短信在过去 3 个月内的情况，可以了解短信的发送状态。

状态

        use Netgsm\Sms\SmsSend;
        $sms=new SmsSend;
        $data=array('bulkid'=>'1311042194','bastar'=>'010220231500','bittar'=>'070220231500','status'=>'100','type'=>2);
        //bulkid girildiğinde type 0 gönderilmelidir.type=0 girildiğinde bastar ve bittar girilmesine gerek bulunmamaktadır.
        //bastar ve bittar girildiğinde type 2 gönderilmelidir.
        $sonuc=$sms->smsSorgulama($data);
        dd($sonuc);
        die;

成功请求结果

Array
(
    [durum] => İletilmiş olanlar
    [durumcode] => 1
    [operator] => Türk Telekom
    [operatorcode] => 20
    [hataaciklama] => Hata Yok.
    [hatakod] => 0
    [cepno] => 9055xxxxxxx
    [mesajboy] => 1
    [tarih] => 23.01.2023 09:35:00
)

失败请求结果

Array
(
    [code] => 60
    [aciklama] => Arama kriterlerinize göre listelenecek kayıt olmadığını ifade eder.
)

短信取消

您可以取消计划在将来发送的短信，或更改任务时间。

        $sms=new SmsSend;
        $data=array('bulkid'=>'1311176624','startdate'=>'180220230100','stopdate'=>'180220231000','type'=>1);
        //type=0 gönderilirse  startdate ve stopdate gönderilmesine gerek yoktur.
        //type=1 gönderilirse stardate ve stopdate değerleri güncellenebilir.
        $sonuc=$sms->smsiptal($data);
        dd($sonuc);
        die;

成功请求结果

Array
(
    [aciklama] => İleri zamanlı görevinizin başarılı bir şekilde iptal edilğini ifade eder.
    [code] => 00
)

失败请求结果

Array
(
    [aciklama] => Baslangiç ve bitis tarihleri arasindaki fark en az 1 , en fazla 21 saat olmalidir.
    [code] => 60
)

接收短信查询

您可以查询接收到的短信。

        use Netgsm\Sms\SmsSend;	
        $islem=new SmsSend;
        $data=array('startdate'=>'120120230940','stopdate'=>'230120231400');
        $sonuc=$islem->gelensms($data);
        dd($sonuc);
        die;

成功请求示例结果

Array
(
    [0] => Array
        (
            [telno] => 553xxxxxxx 
            [mesaj] =>  mesaj_içerigi
            [tarih] =>  12.01.2023 09:43:51
        )

    [1] => Array
        (
            [telno] => 553xxxxxxx 
            [mesaj] =>  mesaj_içerigi
            [tarih] =>  12.01.2023 09:43:04
        )

)

失败请求示例结果

Array
(
    [code] => 60
    [aciklama] => Arama kiterlerindeki startdate ve stopdate zaman farkının 30 günden fazla olduğunu ifade eder.
)

接收短信 Webhook

  • 我们将接收到的短信实时发送到您指定的 URL 地址。
  • 您可以通过点击 SMS 服务 / 交互 SMS 菜单中的 URL 转发模块 来完成此操作。
  • 发送到指定 URL 的数据将以 post 的方式发送。
  • 发送的 post 值是 ceptel 和 mesaj。

您指定的 URL 将收到以下数据。

{
    "mesaj": "test",
    "ceptel": "553xxxxxxx",
    "aboneno": "312xxxxxxx",
    "gorevid": "112xxx720",
    "tarih": "2023-02-21 16:28:41.053"
}
如果您使用 Laravel，可以按照以下方式获取数据
    public function index(Request $request)
    {
        //
        $request->ceptel;
        $request->mesaj;
        $request->aboneno;
        $request->gorevid;
        $request->tarih;
    }
如果您使用 Symfony，可以按照以下方式获取数据
    use Symfony\Component\HttpFoundation\Request;
    public function index(Request $request)
    {
    
        
        $request->get('ceptel');
        $request->get('mesaj');
        $request->get('aboneno');
        $request->get('gorevid');
        $request->get('tarih');
        
     }

标题(发送者名称)查询

这是一个查询您账户中定义的发送者名称（消息标题）的模块。

        use Netgsm\Sms\SmsSend;
        $baslik=new SmsSend;
        $sonuc=$baslik->basliksorgu();
        dd($sonuc);
        die;

成功请求示例结果

Array
(
    [msgheader] => Array
        (
            [0] => 850xxxxxxx
            [1] => HEADER_BILGISI
        )

)

失败请求示例结果

Array
(
    [code] => 30
    [error] => Kullanici bilgisi bulunamadi
)

黑名单

黑名单也称为 SMS 发送禁止号码列表，您可以使用添加到黑名单/从黑名单中删除模块添加或删除您指定的号码。黑名单中的号码将不会从您的账户发送短信。此检查由 Netgsm 提供。

        use Netgsm\Sms\SmsSend;
       	$karaliste=new SmsSend;
        $data=array('number'=>['553xxxxxxx','553xxxxxxx'],'tip'=>2);
        $sonuc=$karaliste->karaliste($data);
        dd($sonuc);
        die;

成功请求示例结果

Array
(
    [code] => OK
    [aciklama] => Kara Listeye Ekleme / Çıkarma işleminde bir hata olmadığını gösterir.
)

失败请求示例结果

Array
(
    [code] => 60
    [aciklama] => Geçersiz tip gönderimi
)

闪信

您的短信将在用户的手机屏幕上以通知的形式显示。
订阅号码必须是企业号码。

        use Netgsm\Sms\SmsSend;
       	$data=array('message'=>'Test','gsm'=>['553xxxxxxx','553xxxxxxx'],
                    'header'=>'312xxxxxxx',
                    'encoding'=>'tr',
                    'startdate'=>'170220231418',
                    'stopdate'=>'170220231425',
                    'filter'=>0,
                    'bayikodu'=>132,
                    'appkey'=>'hsfxa-xhytf21-....',
        );
        $islem=new SmsSend;
        $sonuc=$islem->flashSms($data);
        dd($sonuc);
        die;

成功请求示例结果

Array
(
    [aciklama] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
    [code] => 00
    [bulkid] => 1311191776
)

失败请求示例结果

Array
(
    [code] => 30
    [aciklama] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

606d569e1950e7b988a2073eaae9e031c79d926a