指定模板单发

1.协议说明

2.请求包体

3.应答包体

1 协议说明

协议 HTTP POST
编码格式 UTF8
URL 举例:https://msg.yundashi.com/intf/sendsms?sdkappid=xxxxx&random=xxxx
接口说明 给用户发短信验证码、短信通知,营销短信(内容长度不超过 450 字)。注:sdkappid请填写您在云大师短信官网上申请到的客户编号,random请填成随机数。

2 请求包体

包体为json字符串,参数如下:

    {
    "tel": { 
        "nationcode": "86", //国家码
        "mobile": "13788888888" //手机号码
    }, 
    "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 object 手机号
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"; //tel的mobile字段的内容
string strAppKey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&mobile=$strMobile);

3 应答包体

{
    "result": 0, //0表示成功(计费依据),非0表示失败
    "errmsg": "OK", //result非0时的具体错误信息
    "ext": "", //用户的session内容,云大师server回包中会原样返回
    "sid": "xxxxxxx", //标识本次发送id,标识一次短信下发记录
    "fee": 1 //短信计费的条数
}

results matching ""

    No results matching ""