接口描述
功能描述
给用户群发通知类或营销类短信。
手机号码需全部为国内手机号码或全部为国际/港澳台手机号码，单次请求最多支持提交200个手机号，也支持单发短信。
URL 示例
POST https://yun.tim.qq.com/v5/tlssmssvr/sendmultisms2?sdkappid=xxxxx&random=xxxx
请求参数
请求参数如下表所示。
参数 | 必选 | 类型 | 描述 |
ext | 否 | string | 用户的 session 内容，腾讯 server 回包中会原样返回，可选字段，不需要就填空。 |
extend | 否 | string | |
params | 是 | array | 模板参数，该字段需结合 tpl_id字段使用。若模板没有自定义变量参数，请设置为空数组。 |
sig | 是 | string | |
sign | 是 | string | 短信签名内容，使用 UTF-8 编码，必须填写审核通过的签名。 |
tel | 是 | array | 群发号码数组，群发时一次最多不要超过200个手机号。 |
time | 是 | number | 请求发起时间，UNIX 时间戳（单位：秒），如果和系统时间相差超过10分钟则会返回失败。 |
tpl_id | 是 | number | 模板 ID，必须填写审核通过的模板 ID。 |
数组
tel元素参数：参数 | 必选 | 类型 | 描述 |
mobile | 是 | string | 手机号码 |
nationcode | 是 | string | 国家（或地区）码 |
说明：
字段：根据公式
sigsha256（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;
请求示例：
{"ext": "","extend": "","params": ["验证码","1234","4"],"sig": "be66bb4aeb54701ed0637d0996a0b75111d5b8eda9b3a71bdc579a3d26f3edfb","sign": "腾讯云","tel": [{"mobile": "13788888888","nationcode": "86"},{"mobile": "13788888889","nationcode": "86"}],"time": 1457336869,"tpl_id": 19}
响应参数
响应参数如下表所示。
参数 | 必选 | 类型 | 描述 |
result | 是 | number | 错误码，0表示成功（计费依据），非0表示失败。 |
errmsg | 是 | string | 错误消息，result 非0时的具体错误信息。 |
ext | 否 | string | 用户的 session 内容，腾讯 server 回包中会原样返回。 |
detail | 否 | array | 结果详细。 |
数组
detail 元素参数：参数 | 必选 | 类型 | 描述 |
result | 是 | number | |
errmsg | 是 | string | 错误消息，result 非0时的具体错误信息。 |
fee | 否 | number | |
mobile | 是 | string | 手机号码。 |
nationcode | 是 | string | 国家（或地区）码。 |
sid | 否 | string | 本次发送标识 ID，标识一次短信下发记录。 |
响应示例：
{"result": 0,"errmsg": "OK","ext": "","detail": [{"errmsg": "OK","fee": 1,"mobile": "13788888888","nationcode": "86","result": 0,"sid": "xxxxxxx"},{"errmsg": "OK","fee": 1,"mobile": "13788888889","nationcode": "86","result": 0,"sid": "xxxxxxx"}]}
DEMO
