kreateyou / vumasms
发送短信
v0.0.2
2020-04-02 08:25 UTC
Requires
- guzzlehttp/guzzle: ^6.3
This package is auto-updated.
Last update: 2024-09-29 05:01:56 UTC
README
此库需要PHP版本至少为5.6
这是用于使用VumaSMS API的PHP客户端库。要使用此库,您需要一个vumasms账户。在vumasms.com免费注册(免费注册)。这是一个测试版本,有关更多信息,请参阅贡献。
安装
要使用客户端库,您需要先创建VUMASMS账户。
使用Composer安装PHP客户端库
composer require kreateyou/vumasms
获取API密钥
- 登录您的VumaSMS账户。
- 点击左侧菜单中的设置
- 点击生成API凭据按钮
- 将密钥和秘密保存在您的应用中注意:vumaSMS不会存储生成的API密钥或凭据,每次都会生成新的密钥,请保存密钥以供以后使用
用法
如果您使用Composer,请确保将自动加载器包含在项目的引导文件中
require_once "vendor/autoload.php";
使用API密钥和秘密创建客户端
$client = new \Vumasms\VumaSMS(API_KEY, API_SECRET);
示例
发送短信
要使用VumaSMS的短信API发送短信,请调用$client->send()
方法。
API可以直接调用,使用简单的参数数组,键如下。
to // array of receipients sender // registered sender ID, default VUMA message // message scheduled_date // date to be sent can be Datetime or Cron Expression scheduled_type // date or cron
$messageBag = [ 'to' => [2547XXXXXX], 'sender' => VUMA, 'message' => 'Test message from the vumaSMS PHP Client' ]; $message = $client->send($messageBag);
API响应的JSON数据如下。
{"success":true,"details":{"type":"outbox","status":"queued","payload":{"to":["2547XXXXXX"],"message":"Your verification code for PROJECT is 3434 \n","sender":"VUMA","scheduled_date":null,"scheduled_type":null},"created_by":"17","scheduled_at":null,"updated_at":"2018-04-18 10:14:22","created_at":"2018-04-18 10:14:22","sid":"36"}};
Laravel
要在laravel 5.x中使用组件,请在Provider中添加VumaSMS提供者
Vumasms\Laravel\Providers\ServiceProvider::class,
按照以下方式发布服务提供者
php artisan vendor:publish --provider "Vumasms\Laravel\Providers\ServiceProvider"
在您的配置文件夹中找到vumasms.php配置,更改密钥和秘密配置。如果您使用.env配置文件,请按照以下方式在.env文件中添加您的密钥和秘密
# VUMA SETTINGS VUMA_API_KEY=<KEY> VUMA_API_SECRET=<SECRET>
在laravel中发送短信如下
app("vumasms")->send($messageBag),
贡献
要为此库、文档或示例做出贡献,请[创建问题][issues]或发起拉取请求。请只提出关于已标记为在API覆盖率中正在工作功能的问题,因为其余代码正在更新。
许可证
此库根据MIT许可证发布