bmqb-sms

0.2.2 • Public • Published

bmqb-sms 贝米钱包第三方短信发送SDK

npm version Build Status

安装:

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捕获返回结果

Readme

Keywords

Package Sidebar

Install

npm i bmqb-sms

Weekly Downloads

1

Version

0.2.2

License

ISC

Last publish

Collaborators

  • harveyz