HTTP接口文档
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
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 主动接收上行短信（回复）
操作的格式：