技术支撑 > 使用场景 > 群发短信

群发短信

  1. 调通短信接口

    使用短信接口API直接开发
    短信发送API支持多种编码格式提交

  1. 请求

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

    编码格式:GB2312
    访问方式:GET和POST

    URL:http://api.sms1086.com/api/Sendutf8.aspx 

    编码格式:UTF8
    访问方式:GET和POST

    URL: http://api.sms1086.com/api/Sendgbk.aspx 

    编码格式:GBK
    访问方式:GET和POST

  1. 请求参数

类别 参数名称 类型 说明
输入 username string(必填) 用户名称
输入 password string(必填) 用户密码,密码为加密传递,格式为(MD5(用户密码+时间戳)),小写字母的形式,例如密码为 “123456”,时间戳为“2013-01-01 12:00:00”,则密码为“f7691041c73d827174dcbff6f4f9b8cc
输入 content string(必填) 短信内容(参数内容编码必须为GB2312)
输入 mobiles string(必填) 目的号码 (多个号码用英文”,”分隔)最多一次600个号码
输入 attime string(选填) 定时时间,可为空,格式:’2009-09-01 12:30:00’ 格式为: yyyy-MM-dd HH:mm:ss
输入 faillist string(选填) 提交时检测方式
1 --- 提交号码中有效的号码仍正常发出短信,无效的号码在返回参数faillist中列出
不为1 或该参数不存在 --- 提交号码中只要有无效的号码,那么所有的号码都不发出短信,所有的号码在返回参数faillist中列出
输入 timestamp string(必填) 时间戳,格式为(yyyy-MM-dd HH:mm:ss),且时间要与北京时间一致.
输入 Linkid string(选填)
  1. 请求示例

public string smssend(string username,string password,string mobiles,string content)
    {
        username= System.Web.HttpUtility.UrlEncode(username, Encoding.GetEncoding("GB2312"));
        content = System.Web.HttpUtility.UrlEncode(content, Encoding.GetEncoding("GB2312"));

        string sendurl = string.Format("0verifycode.aspx?username=1&password=2&mobiles=3&content=4"
            , url
            ,username
            ,password
            ,mobiles
            ,content);
        return  HttpGet(sendurl);
  1. 响应

返回值 错误描述
0 发送短信成功
1 提交参数不能为空
2 用户名或密码错误
3 账号未启用
4 计费账号无效
5 定时时间无效
6 业务未开通
7 权限不足
8 余额不足
9 号码中含有无效号码
10 内容中含有非法关键字
11 随机加密域无效
12 系统错误
13 没有加签名,或者签名格式不正确
正确的签名格式:
短信内容短信内容短信内容短信内容短信内容【签名】
14 审核失败提交号码数量过少
15 不在发送时段
16 一次提交号码过多,单次提交号码个数不能多于600
17 短信内容超长,请联系客服解决
18 提交计费错误,请联系客服解决
19 暂无通道或者通道设置错误,请联系客服解决
20 时间戳格式不正确或时间戳时间不正确
21 签名不正确,请在短信的末尾加【会员】
22 同一内容提交号码过多
23 验证码接口中,内容不包含验证码
24 内容中未添加退订或者退订添加不正确
  1. 返回示例

     result=状态码&balance=当前余额&linkid=网关序号&description=错误描述
  1. 实现业务逻辑

  • 生成短信内容,调用发送接口,传入用户名账号、密码、手机号、内容等参数发送短信。
  • 短信内容需按照文档介绍的参数格式相符才能发送,如不匹配接口会返回报错信息,报错状态码在上方响应页可以看到。
  • 短信API需审核短信内容。