HTTP接口文档
接口域名：
一、工作方式....................................................................... 错误!未定义书签。

1.1 密码验证方式............................................................................... 错误!未定义书签。

二、字符编码....................................................................... 错误!未定义书签。

三、响应格式....................................................................... 错误!未定义书签。

四、短信发送（单条，多条发送）...................................... 错误!未定义书签。

五、接收状态报告................................................................ 错误!未定义书签。

5.1 主动获取状态............................................................................... 错误!未定义书签。

六、接收上行短信（回复）................................................. 错误!未定义书签。

6.1 主动接收上行短信（回复） ......................................................... 错误!未定义书签。

6.2 推送接收上行短信（回复） ......................................................... 错误!未定义书签。

七、取剩余短信条数............................................................ 错误!未定义书签。

八、取已发送总条数............................................................ 错误!未定义书签。

九、接口安全（绑定IP）.................................................... 错误!未定义书签。

十、取发送记录 ................................................................... 错误!未定义书签。

一、工作方式
双方通过HTTP方式交互数据，第三方可以简单的“name=value”方式发送提交内容或响应请求内容。

即通过HTTP的GET/POST方式交换。

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

1.1 密码验证方式
接口密码使用“登录密码”与“用户名”拼接字符串后能过md5加密进行验证
如登录密码是：123123
如用户名是：test
接口密码（pwd）=md5(登录密码+用户名)
pwd=md5(123123test)
pwd=b9887c5ebb23ebb294acab183ecf0769
二、字符编码
服务器接收数据可以是GBK或UTF-8编码字符,默认接收数据是GBK编码,如提交的是UT F-8编码字符,需要添加参数encode=utf8。

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

三、响应格式
所为响应即每次向服务器提交请求后返回值
响应值格式为纯文本
四、短信发送（单条，多条发送）
GET/POST操作格式：
/?uid=用户账号&pwd=MD532位密码&mobile=号码&mobileids=消息编号&cont ent=内容
接口参数说明:
接收号：,1390000test,
发送内容：发送测试
/?uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769&mobile=,1390000test,&mo bileids=888,1390000test,666&content=%B7%A2%CB%CD%B2%E2%CA%D4
发成功时响应状态码值:
sms&stat=100&message=发送成功
stat 状态码
message 状态说明
返回发送的状态码
状态码说明
100 发送成功
101 验证失败
102 短信不足
103 操作失败
104 非法字符
105 内容过多
106 号码过多
107 频率过快
108 号码内容空
109 账号冻结
110 禁止频繁单条发送
112 号码错误
113 定时时间格式不对
114 账号被锁，10分钟后登录
116 禁止接口发送
117 绑定IP不正确
120 系统升级
五、接收状态报告
5.1 主动获取状态
GET/POST操作格式：
/?uid=用户账号&pwd=MD532位密码
例:
/?uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769 响应返回值:
,100,556789,2011-03-11 11:22:11
,100,556311,2011-03-11 11:28:22
说明：
手机号,状态,发送唯一编号,状态返回时间+换行
每条状态记录以换行分隔，一行一条状态记录
六、接收上行短信（回复）
6.1 主动接收上行短信（回复）
操作的格式：
/?uid=用户账号&pwd=MD532位密码
注：提取的回复短信不能在重复提取
接口参数说明:
例:
/?uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769
响应结果为纯文本,每次可接收多条回复信息：
状态码{&}回复号码||回复内容||回复时间||回复网关号{&}回复号码||回复内容||回复时间||回复网关号…….
例响应结果值:
100{&}||短信测试回复||2008-05-27 12:10:11||27282{&}||短信测试回复2||2009-05-2 7 13:11:11||1068
返回发送的状态码
无回复内容时返回空
注：对回复的内容中有||会自动转成全角｜｜字符串
6.2 推送接收上行短信（回复）
使用说明：由服务器平台发送上行回复短信到您的接口程序上，使用Http协议GET和PO ST方式发送，您需要提交一个http接口地址来接收如下格式参数值
操作的格式：
接口参数说明:
七、取剩余短信条数
操作格式：
/?uid=用户账号&pwd=MD5位32密码
接口参数说明:
例:
/?uid=test&pwd=fa246d0262c3925617b0c72bb20eeb1d
响应结果为纯文本：
sms&stat=状态码&remain=剩余可发短信
例响应结果值:
sms&stat=100&remain=100
八、取已发送总条数
操作格式：
/?uid=用户账号&pwd=MD5位32密码&cmd=send
接口参数说明:
例:
/?uid=test&pwd=fa246d0262c3925617b0c72bb20eeb1d&cmd=send
响应结果为纯文本：
sms&stat=状态码&remain=已发短信
例响应结果值:
sms&stat=100&remain=100
九、接口安全（绑定IP）
为了接口更加的安全，请登录WEB平台在“系统设置”中绑定你服务器的IP地址，可绑定1 0个固定IP,绑定IP后只有通过你的服务器来发送短信，防止他人使用
十、取发送记录
操作的格式：
/?uid=用户账号&pwd=MD532位密码&page=1
接口参数说明:每次最多取50条记录，可以根据页数依次取完
例:
/?uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769
响应结果为纯文本,每记录用“|#|”隔开，每个字段之间用“||”;
返回如下格式：
总记录数||当前记录数||总页数|#|发送时间||号码||内容||状态|#|发送时间||号码||内容| |状态|#|…….
无回复内容时返回空。