SMS服务扩展，提供统一的基于模板的短信服务接口，便于在各种短信服务提供商之间自由切换。
$ npm install smsex
使用前必须先定义提供商，实现发送短信方法。提供商定义参见Provider。
var smsex = require('smsex');
var YourProvider = require('your_provider');
var provider = new YourProvider('account', 'password');
smsex.use(provider);
smsex.send('13800000000', '千年田地八百主，田是主人人是客。', function (err, result) {
if (!err) { console.log(result); }
});由于绝大多数供应商不支持直接发送短信，而必须事先定义好短信模板，因此以上方法不推荐使用。定义默认模板如下：
smsex.template('register', '您的验证码是：{{code}}，请不要把验证码泄露给其他人。');
// 各服务商短信模板可能不同，因此推荐为各服务商定义自己的模板
// provider.templates = {'register': '您的验证码是：{{code}}，请不要把验证码泄露给其他人。'};
smsex.send({
to: '13800000000',
body: {
code: 850119
},
template: 'register'
}, function (err, result) {});可以同时使用多家短信提供商，不同的提供商按名称(name)区分。自定义多个模板举例：
var ap = new AProvider('account', 'password');
var bp = new BProvider('appKey', 'appSecret');
ap.templates = {
register: '您的验证码是：{{code}}，请不要把验证码泄露给其他人。',
order, '您的订单[编号：{{number}}]{{status}}，下载客户端({{url}})实时查看您的订单状态。'
};
ap.templates = {
register: 'Your verification code is：{{code}}, please do not tell others.',
order, 'Your order[No.{{number}}]{{status}}, download APP ({{url}}) to check the status anytime.'
};
smsex.use('a', ap);
smsex.use('b', bp);
smsex.send({
to: '13800000000',
body: {
number: '850119850119850119',
status: '已发货',
url: 'https://github.com/loulin'
},
provider: 'a',
template: 'order'
}, function (err, result) {});name- 可选的供应商名称，不提供时使用provider.nameprovider- 供应商实例，第一次调用时会被设置为默认供应商
name- 模板名称content- 模板内容，模板使用Mustache引擎，语法请参考Mustache文档。
templates- 批量模板对象，可同时指定多个模板名值对(name, content)，如{name1: 'content1', name2, 'content2'}。
options- 发送选项:to- 必选，目标手机号码。body- 必选，发送内容，String或者Object，为Object时作为模板数据源。template- 必选，模板名称。provider- 可选，供应商名称，不选时使用默认供应商。
Provider类必须实现以下方法
function send(options, cb) {}
options- 发送选项:to- 目标手机号(String)content- 发送内容(String)template- 模板编号(适用于使用模板编号的服务商)(Integer)body- 发送内容(适用于使用模板编号的服务商)(Object)cb- 回调函数(Function)
举例(ES6)：
class AProvider {
constructor(account, password) {
this.account = account;
this.password = password;
this.name = 'a';
}
send(options, cb) {
return request.post('https://github.com/loulin', {
account: this.account,
password: this.password,
mobile: options.to,
content: options.content
}).then((err, res) => {
if (err) {
return cb(error);
}
return cb(null, res.body);
});
}
}
export default AProvider;
MIT