接口描述
功能描述
给用户发短信验证码、通知类短信或营销短信。
URL 示例
POST https://yun.tim.qq.com/v5/tlssmssvr/sendsms?sdkappid=xxxxx&random=xxxx
其中,sdkappid
请填写您在 短信控制台 添加应用后生成的实际 SDK AppID,random
请填写成随机数。
请求参数
请求参数说明如下表所示。
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
ext | 否 | string | 用户的 session 内容,腾讯 server 回包中会原样返回,可选字段,不需要时设置为空 |
extend | 否 | string | 短信码号扩展号,格式为纯数字串,其他格式无效。默认没有开通,如需开通请联系 sms helper |
params | 是 | array | 模板参数,该字段需结合tpl_id 字段使用。若模板没有自定义变量参数,请设置为空数组 |
sig | 是 | string | App 凭证,具体计算方式请参见下方 说明 |
sign | 是 | string | 短信签名内容,使用 UTF-8 编码,必须填写已审核通过的签名 签名信息可登录 短信控制台 查看 |
tel | 是 | object | 国际电话号码,格式依据 e.164 标准为:[国家(或地区)码][手机号] ,例如8613711112222 , 其中86 为国家码,13711112222 为手机号 |
time | 是 | number | 请求发起时间,UNIX 时间戳(单位:秒),如果和系统时间相差超过10分钟则会返回失败 |
tpl_id | 是 | number | 模板 ID,必须填写已审核通过的模板 ID 模板信息可登录 短信控制台 查看 |
参数tel
:
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
mobile | 是 | string | 手机号码 |
nationcode | 是 | string | 国家(或地区)码 |
string strMobile = "13788888888"; //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)
= ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4;
请求示例:
{
"ext": "",
"extend": "",
"params": [
"验证码",
"1234",
"4"
],
"sig": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4",
"sign": "腾讯云",
"tel": {
"mobile": "13788888888",
"nationcode": "86"
},
"time": 1457336869,
"tpl_id": 19
}
响应参数
响应参数说明如下表所示。
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
result | 是 | number | 错误码,0表示成功(计费依据),非0表示失败,更多详情请参见 错误码 |
errmsg | 是 | string | 错误消息,result 非0时的具体错误信息 |
ext | 否 | string | 用户的 session 内容,腾讯 server 回包中会原样返回 |
fee | 否 | number | 短信计费的条数,计费规则请参考 国内短信内容长度计算规则 或 国际/港澳台短信内容长度计算规则 |
sid | 否 | string | 本次发送标识 ID,标识一次短信下发记录 |
响应示例:
{
"result": 0,
"errmsg": "OK",
"ext": "",
"fee": 1,
"sid": "xxxxxxx"
}
Demo
腾讯云短信服务为您提供了 Java SDK、PHP SDK、Python SDK、Node.js SDK 和 C# SDK 供您参考,欢迎查阅。
</span id="sig">