bmqb-sms
v0.2.2
Published
BMQB SMS package
Downloads
6
Readme
bmqb-sms 贝米钱包第三方短信发送SDK
安装:
npm install bmqb-sms
使用方式:
####1. 必要配置:
{
'smser': 'yuntongxin',
'debug': true,
'config': {
...
}
}
smser
: 指定发送渠道config
: 发送渠道必要配置(接口鉴权等必要配置信息)debug
: [可选], 为true
时,将在命令行输出接口请求详细信息
####2. 调用方式:
//以yuntongxin为例
const options = {
'smser': 'yuntongxin',
'config': {
'sandbox': true,
'account_sid': '00000000000000000000000000000000',
'auth_token': '00000000000000000000000000000000',
'app_id': '00000000000000000000000000000000',
'vcode_template_id': 1,
'vcode_timeout_min': 10,
},
};
const sms = new BmqbSms(options);
sms.sendVcode('13871451762', '你的验证码是...').then(res => {
console.log(res);
});
####3. API:所有API均以Promise对象作为返回结果。
- sendVcode(mobile, msg): 发送短信验证码
- sendSms(mobile, msg): 单条短信发送
- sendVoiceVcode(mobile, code): 发送语音验证码,目前仅支持云通信
- sendPkg(pkg): 群发,
强制限定每次发送条数不得超过 1000 条,请注意分片发送
。格式为:
[
{
"phone": "手机号1",
"context": "%E6%B5%8B%E8%AF%950"
},
{
"phone": "手机号2",
"context": "%E6%B5%8B%E8%AF%951"
},
{
"phone": "手机号3",
"context": "%E6%B5%8B%E8%AF%952"
}
]
NOTICE: 不支持某种发送方式的渠道,当调用该种方式API时,将会抛出异常!
####4. 返回结果:
约定返回结果为一个SmsResponse
对象,该对象有以下属性:
- status: 请求状态(success|failed)
- ssid: 发送批次号
- body: 接口原始响应结果
通过promise.then捕获返回结果