dun-sms v0.0.5

网易易盾短信验证码 for nodejs

功能概述

• 国内验证码短信 - 发送国内验证码和校验验证码
• 国内通知类短信 - 发送国内通知

使用前必读

版本要求

nodejs >= 8.3.0

安装

npm i dun-sms

# 如已安装旧版, 重新安装最新版
npm i dun-sms@latest

实例化

const {SMS} = require("dun-sms")
const config = {
  secretId: '产品秘钥id',
  secretKey: '产品私钥'
};
// 一般模式
const api = new SMS(config);

// 调试模式(传入第二个参数为true, 可在控制台输出数据)
const api = new SMS(config, true);

config说明:

• secretId - 产品秘钥id(必填)
• secretKey - 产品私钥(必填)

通用响应字段

所有接口响应值采用 json 格式， 如无特殊说明，每次请求的返回值中，都包含下面字段：

功能

1.发送短信验证码:

/**
* 发送短信验证码
* @param mobile 手机号 (必填)
* @param code 短信内容 (选填)
* @param templateId 模板id (必填)
* @param businessId 国内验证码短信 业务id (必填)
* @return
*/
sendCode(mobile, code, templateId, businessId){}

说明:

• code - 短信内容(选填) 验证码数字个数，支持范围4-10 .如果code为空或者不传,则默认生成6位验证码
• 验证码有效期为300秒

响应结果

响应字段如下，响应通用字段已省略，详细见 ###通用响应字段

data 数据结构

2.校验短信验证码:

/**
     * 验证码校验
     * @param {*} requestId 短信发送接口返回的requestId字段
     * @param {*} code 用户填写的验证码
     * @returns 
     */
verify(requestId, code, businessId){}

请求参数:

响应结果

响应字段如下，响应通用字段已省略，详细见 ###通用响应字段

data 数据结构

3.发送自定义短信:

/**
     * 发送自定义短信
     * @param mobile 手机号
     * @param json 短信内容
     * @param templateId 模板id
     * @param businessId 国内通知类短信 业务id
     * @return
     */
      sendData(mobile, json, templateId, businessId){}

示例:

// 模板为:预订通知：用户${name}已成功预定${room}房间，预定时间自${start}至${end}止。
 let json = {
    "name":"杜先生",
    "room":"VIP888房间",
    "start":"2022-01-07 10:00",
    "end":"2022-01-07 16:00"
}
 await api.sendData(13800138000,json,"模板id","国内通知类短信 业务id")

响应结果

响应字段如下，响应通用字段已省略，详细见 ###通用响应字段

data 数据结构

其他说明

详细信息参照: https://support.dun.163.com/documents/2018101001?docId=210168759616458752