您的位置:首页 > 理论基础 > 计算机网络

企信通短信接口(HTTP)

2017-12-06 18:23 120 查看

官网地址: http://www.cnsms.cn/index.html

1.工作方式

双方通过HTTP方式交互数据,第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。

另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名和密码的方式。

2.字符编码

服务器接收数据可以是GBK或UTF-8编码字符,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8。

请求响应返回内容是GBK编码。

3.响应格式

所为响应即每次向服务器提交请求后返回值,响应值格式为纯文本状态码

如发送成功后返回 100

4.短信发送

GET/POST操作格式: http://api.cnsms.cn/?ac=send&uid=用户账号&pwd=MD5位32密码&mobile=号码&content=内容

接口参数说明:



例: 接 收 号:13900008888,13900009999,13100006666,0218882228

发送内容:中国企信通发送测试

http://api.cnsms.cn/tx/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&mobile=13900008888,13900009999,13100006666,0218882228& content=%D6%D0%B9%FA%B6%CC%D0%C5%CD%F8%B7%A2%CB%CD%B2%E2%CA%D4 

发成功时,响应状态码值: 100

返回发送的状态码

状态码说明

100  发送成功

101  验证失败

102  短信不足

103  操作失败

104  非法字符

105  内容过多

106  号码过多

107  频率过快

108  号码内容空

109  账号冻结

110  禁止频繁单条发送

111  系统暂定发送

112  号码错误

113  定时时间格式不对

114  账号被锁,10分钟后登录

115  连接失败

116  禁止接口发送

120  系统升级

5.接收回复短信

操作的格式: http://api.cnsms.cn/?ac=gr&uid=用户账号&pwd=MD5位32密码

注:提取的回复短信不能在重复提取,可以通过time参数重复提取某个时间的所有回复短信,需要间隔10分钟提取一次,不能频繁提取。



例: http://api.cnsms.cn/ac=gr&uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d

响应结果为纯文本,每次可接收多条回复信息:

状态码{&}回复号码||回复内容||回复时间||回复网关号{&}回复号码||回复内容||回复时间||回复网关号…….

例响应结果值:

100{&}13912341234||中国短信测试回复||2008-05-27 12:10:11||1068112227282{&}15912343333||中国短信测试回复2||2008-05-27 13:11:11||106811222728200

返回发送的状态码

无回复内容时返回空

状态码说明

100 接收成功

101 验证失败

6.取剩余短信条数

操作格式: http://api.cnsms.cn/?ac=gc&uid=用户账号&pwd=MD5位32密码



例: http://api.cnsms.cn/?ac=gc&uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d

响应结果为纯文本:

状态码||剩余可发短信

例响应结果值:

100||22348

7.取已发送总条数

操作格式: http://api.cnsms.cn/?ac=gc&uid=用户账号&pwd=MD5位32密码&cmd=send



例: http://api.cnsms.cn/?ac=gc&uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&cmd=send

响应结果为纯文本:

状态码||总发短信条数

例响应结果值:

100||22348

状态码说明

100 请求成功

101 验证失败
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签:  短信