短信接口
HTTP接口文档
接口域名：api.sms.cn
一、密码验证方式 ............................................................................................ 1 二、字符编码 ................................................................................................... 1 三、响应格式 ................................................................................................... 2 四、短信发送（单条，多条发送） .................................................................. 2 五、接收状态报告 ............................................................................................ 3
5.1 主动获取状态 .......................................................................................................... 3 5.2 推送接收状态报告 ................................................................................................... 4
六、接收上行短信（回复） ............................................................................. 5
6.1 主动接收上行短信（回复） .................................................................................... 5 6.2 推送接收上行短信（回复） .................................................................................... 6
七、取剩余短信条数 ........................................................................................ 6 八、取已发送总条数 ........................................................................................ 6 九、接口安全（绑定IP） ................................................................................ 7 十、取发送记录 ............................................................................................... 7 十一、修改密码 ............................................................................................... 8
一、密码验证方式
接口密码使用“登录密码”与“用户名”拼接字符串后能过md5加密进行验证
如登录密码是：123123 如用户名是：test
接口密码（pwd）=md5(登录密码+用户名) pwd=md5(123123test)
pwd=b9887c5ebb23ebb294acab183ecf0769
二、字符编码
- 1 -
短信接口
服务器接收数据可以是GBK或UTF-8编码字符,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8。 请求响应返回内容是GBK编码。
三、响应格式
所为响应即每次向服务器提交请求后返回值 响应值格式为纯文本
四、短信发送
http://api.sms.cn/mt/?uid=用户账号&pwd=MD532位密码&mobile=号码&mobileids=消息编号&content=内容
接口参数说明: 参数名 uid 参数字段 用户账号 登录名 32位MD5加密md5(密码+uid) 如登录密码是：123123 ，uid是：test; pwd=md5(123123test) pwd=b9887c5ebb23ebb294acab183ecf0769 可选项，及时发送时参数无 格式:YYYY-MM-DD HH:MM 如：\2010-05-27 12:01\ (年-月-日 时:分),发送时间以北京时间为准 可选项，根据用户账号是否支持扩展 可选项，默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数 encode=utf8 同时发送给多个号码时,号码之间用英文半角逗号分隔(,);小灵通需加区号 参数说明 pwd 用户密码 time mid encode 定时时间 子扩展号 字符编码 mobile 接收号码 如:13972827282,13072827282 GET 方式每次最多可以提交50条号码 POST 方式每次最多可以提交2000条号码[建议用POST方式提交] 可选项 该参数用于发送短信收取状态报告用，格式为消息编号+逗号；与接收号码一一对应，可以重复出现多次。 mobileids 消息编号 消息编号:全部由数字组成接收状态报告的时候用到，该消息编号的格式为目标号码+当前时间戳整数，精确到毫秒，确保唯一性。供收取状态报告用 如: 1590049111112869461937; - 2 -
短信接口
发送内容需要进行URL字符标准化转码。 {URL字符编码说明:返回字符串，此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号（%）后跟两位十六进制数，空格则编码content 短信内容 为加号（+）} ASP：server.URLEncode(\短信内容\) PHP：urlencode(\短信内容\) JAVA：java.net.URLEncoder.encode(\短信内容\) 例:
接 收 号：13900008888,1390000test,13100006666 发送内容：发送测试
http://api.sms.cn/mt/?uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769&mobile=13900008888,1390000test,13100006666&mobileids=13900008888
12869461937,1390000test12869461937,1310000666612869461937&content= ·￠?í2aê? 发成功时响应状态码值:
sms9&stat=100&message=发送成功
stat 状态码
message 状态说明
返回发送的状态码 状态码 说明 100 发送成功 101 验证失败 102 短信不足 103 操作失败 104 非法字符 105 内容过多 106 号码过多 107 频率过快 108 号码内容空
110 禁止频繁单条发送 112 号码错误
113 定时时间格式不对 114 账号被锁
116 禁止接口发送 117 绑定IP不正确 120 系统升级
五、接收状态报告
5.1 主动获取状态
http://api.sms.cn/st/?uid=用户账号&pwd=MD532位密码
- 3 -