1 协议说明
| 协议 | HTTP POST |
|---|---|
| 编码格式 | UTF8 |
| URL | 举例：https://msg.yundashi.com/intf/sendmultisms?sdkappid=xxxxx&random=xxxx |
| 接口说明 | 给用户发短信验证码、短信通知，营销短信（内容长度不超过 450 字）。注：sdkappid请填写您在云大师短信官网上申请到的客户编号，random请填成随机数。 |
2 请求包体
包体为json字符串，参数如下：
{
"tel": [
{
"mobile": "13788888888",//手机号码
"nationcode": "86"//国家码
},
{
"mobile": "13788888889",//手机号码
"nationcode": "86"//手机号码
}
],
"sign": "云大师", //短信签名，如果使用默认签名，该字段可缺省
"tpl_id": 19, //业务在控制台审核通过的模板ID
//假定这个模板为：您的{1}是{2}，请于{3}分钟内填写。如非本人操作，请忽略本短信。
"params": [
"验证码",
"1234",
"4"
], //参数，分别对应上面假定模板的{1}，{2}，{3}
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505",
//app凭证，具体计算方式见下注
"extend": "", //通道扩展码，可选字段，默认没有开通(需要填空)。在短信回复场景中，云大师server会原样返回，开发者可依此区分是哪种类型的回复
"time": 1457336869, //unix时间戳，请求发起时间，如果和系统时间相差超过10分钟则会返回失败
"ext": "" //用户的session内容，云大师server回包中会原样返回，可选字段，不需要就填空。
}
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| tel | 是 | array | 群发号码数组，群发时一次最多不要超过 200 个手机号 |
| sign | 是 | string | 短信签名。 |
| tpl_id | 是 | number | 业务在控制台审核通过的模板ID |
| params | 是 | array | 模板参数，若模板没有参数，请提供为空数组 |
| sig | 是 | string | App 凭证，具体计算方式见下注 |
| type | 是 | number | 短信类型，Enum{0: 普通短信, 1: 营销短信}（注意：要按需填值，不然会影响到业务的正常使用） |
| time | 是 | number | 请求发起时间，unix 时间戳（单位：秒），如果和系统时间相差超过 10 分钟则会返回失败 |
| ext | 否 | string | 用户的 session 内容 server回包中会原样返回，可选字段，不需要就填空 |
| extend | 否 | string | 通道扩展码，可选字段，默认没有开通(需要填空) |
- 数组tel元素参数：
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| mobile | 是 | string | 手机号码 |
| nationcode | 是 | string | 国家码 |
注：
1、"tpl_id"字段需填写审核通过的模板ID ，上面的请求参数组合后下发的内容为：
"【云大师】您的验证码是1234，请于4分钟内填写。如非本人操作，请忽略本短信。"
如果您有多个短信签名，请将需要的短信签名填入"sign"字段
例如您有"【云大师】"，"【云大师讲座】"两个签名，但是想以"【云大师讲座】"签名发送短信，则"sign"字段可赋值为："云大师讲座"
2、"extend"字段的配置请联系 云大师工作人员
3、"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成 伪代码如下：
string strMobile = "13788888888,13788888889"; //tel 的 mobile 字段的参数值以 "," 分割
string strAppKey = "5f03a35d00ee52a21327ab048186a2c4"; //sdkappid 对应的 appkey，需要业务方高度保密
string strRand = "7226249334"; //url 中的 random 字段的值
string strTime = "1457336869"; //unix 时间戳
string sig = sha256(appkey=5f03a35d00ee52a21327ab048186a2c4&random=7226249334&time=1457336869&mobile=13788888888,13788888889)
= be66bb4aeb54701ed0637d0996a0b75111d5b8eda9b3a71bdc579a3d26f3edfb;
3 应答包体
{
"result": 0,//0表示成功(计费依据)，非0表示失败
"errmsg": "OK",//result非0时的具体错误信息
"ext": "",//用户的session内容，云大师server回包中会原样返回
"detail": [
{
"errmsg": "OK",
"fee": 1,//短信计费的条数
"mobile": "13788888888",
"nationcode": "86",
"result": 0,//0表示成功(计费依据)，非0表示失败
"sid": "xxxxxxx"//标识本次发送id，标识一次短信下发记录
},
{
"errmsg": "OK",
"fee": 1,
"mobile": "13788888889",
"nationcode": "86",
"result": 0,
"sid": "xxxxxxx"
}
]
}