编辑: JZS133 | 2016-05-16 |
sms.cn
一、工作方式
1 1.1 密码验证方式
1
二、字符编码
2
三、响应格式
2
四、短信发送(单条,多条发送)
2
五、接收状态报告
4 5.1 主动获取状态
4
六、接收上行短信(回复)
4 6.1 主动接收上行短信(回复)
4 6.2 推送接收上行短信(回复)
5
七、取剩余短信条数
5
八、取已发送总条数
6
九、接口安全(绑定IP)
6
十、取发送记录
7
一、工作方式 双方通过HTTP方式交互数据,第三方可以简单的 name=value 方式发送提交内容或响应请求内容.即通过HTTP的GET/POST方式交换. 另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名、密码和IP绑定的方式. 1.1 密码验证方式 接口密码使用 登录密码 与 用户名 拼接字符串后能过md5加密进行验证 如登录密码是:123123 如用户名是:test 接口密码(pwd)=md5(登录密码+用户名) pwd=md5(123123test) pwd=b9887c5ebb23ebb294acab183ecf0769
二、字符编码 服务器接收数据可以是GBK或UTF-8编码字符,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8. 请求响应返回内容是GBK编码.
三、响应格式 所为响应即每次向服务器提交请求后返回值 响应值格式为纯文本
四、短信发送(单条,多条发送) GET/POST操作格式: http://api.sms.cn/mt/?uid=用户账号&
pwd=MD532位密码&
mobile=号码&
mobileids=消息编号&
content=内容 接口参数说明: 参数名 参数字段 参数说明 uid 用户账号 登录名 pwd 用户密码 32位MD5加密md5(密码+uid) 如登录密码是:123123 ,uid是:test;
pwd=md5(123123test) pwd=b9887c5ebb23ebb294acab183ecf0769 mid 子扩展号 可选项,根据用户账号是否支持扩展 encode 字符编码 可选项,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数 encode=utf8 mobile 接收号码 同时发送给多个号码时,号码之间用英文半角逗号分隔(,);
小灵通需加区号 如:13972827282,13072827282,02185418874 GET 方式每次最多可以提交50条号码 POST 方式每次最多可以提交2000条号码[建议用POST方式提交] mobileids 消息编号 可选项 该参数用于发送短信收取状态报告用,格式为消息编号+逗号;
与接收号码一一对应,可以重复出现多次. 消息编号:全部由数字组成接收状态报告的时候用到,该消息编号的格式为目标号码+当前时间戳整数,精确到毫秒,确保唯一性.供收取状态报告用 如: 1590049111112869461937;
content 短信内容 发送内容需要进行URL字符标准化转码. {URL字符编码说明:返回字符串,此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号(%)后跟两位十六进制数,空格则编码为加号(+)} 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=1390000888812869461937,1390000test12869461937,1310000666612869461937&
content= %B7%A2%CB%CD%B2%E2%CA%D4 发成功时响应状态码值: sms&
stat=100&
message=发送成功 stat 状态码 message 状态说明 返回发送的状态码 状态码 说明