技术支撑 > 使用场景 > 一对一短信

一对一短信

  1. 调通短信接口

    使用短信接口API直接开发

  1. 请求

     URL: http://api.sms1086.com/Api/SendVarSms.aspx 

    访问方式:GET和POST

  1. 请求参数

类别 参数名称 类型 说明
输入 username string(必填) 用户名称
输入 password string(必填) 用户密码
输入 content string(选填) 短信模板。其中的变量用“$var”来替代。例如:
“$var,你好!,您的八月份工资为$var”,该短信中具有两个变量参数。编码为UTF8格式。注意"$var"一定要加{}!
此内容可以为空,为空的时候,模板中手机号码后面的内容均为短信内容
输入 params string(必填) 变量短信的参数组。单次提交参数组的数目不能超过1000个。编码为UTF8格式
每一组参数之间用英文“|”间隔
每一组参数内部用 separator 指定的分隔符分隔隔,其中第一个参数为手机号码,第二个参数为模板中第一个变量,第三个参数为模板中第二个变量,以此类推。
例如:
13900000000|张三|5000
13900000001|李四|5000
表明提交了两个变量组,其中手机号码分别为:13900000000和13900000001。模板变量分别为:张三,5000和,李四,5000 格式不符的参数,系统自动过滤掉。
注意:消息内容与模板匹配后的内容一次不能超过500000字符
输入 attime string(选填) 定时时间,可为空,格式:’2009-09-01 12:30:00’ 格式为: yyyy-MM-dd HH:mm:ss
此参数为空,表示提交的是即时短信
输入 iscompress string(选填) 提交时的方式 0 表示普通方式 1 表示压缩方式传递 压缩方式传递时,Paramars的内容采用压缩的方式传递
此参数为空,表示为普通方式传递参数
输入 separator string(选填) 此参数用与指定分组的分隔符,如果为空,则表示默认以回车换行为分组的分隔符
  1. 请求示例

public string smssend(string username,string password,string mobiles,string content)
    {
        username = System.Web.HttpUtility.UrlEncode(username, Encoding.GetEncoding("GB2312"));
                String sendurl = string.Format("0SendVarSms.aspx?username=1&password=2&content=3¶ms=4"
            , url
            ,username
            ,password
            ,$var,你好!,您的八月份工资为$var
            ,13900000000|张三|5000;13900000001|李四|5000;13900000002|王五|4500);
        return  HttpGet(sendurl);
  1. 响应

返回值 错误描述
0 发送短信成功
1 提交参数不能为空
2 用户名或密码错误
3 账号未启用
4 计费账号无效
5 定时时间无效
6 号码中含有无效号码
7 权限短信余额不足
8 压缩格式不正确
9 可用参数组个数不正确,请检查参数
10 消息内容或者参数值过长,一次提交的内容长度不能超过500000字符
11 其他错误
12 状态报告错误
13 扩展码格式错误
14 业务编号错误
15 签名不合法或未带签名
16 无此产品
17 用户没有订购该产品
18 产品异常
19 短信内容包含敏感词
20 入库失败
21 不在发送时段
22 账号状态异常
23 用户已过期
24 密码错误
25 IP地址认证错误
  1. 实现业务逻辑

  • 短信内容:$var,你好!,您的八月份工资为$var
    变量短信的参数组:params=13900000000|张三|5000;13900000001|李四|5000;13900000002|王五|4500 ,调用发送接口,传入用户名账号、密码等参数发送短信。
  • 短信内容需按照文档介绍的参数格式相符才能发送,如不匹配接口会返回报错信息,报错状态码在上方响应页可以看到。
  • 短信API需审核短信内容。