HTTP接口文档:短信服务与安全验证

需积分: 15 27 下载量 98 浏览量 更新于2024-07-16 收藏 241KB DOC 举报
该文档详细介绍了如何通过HTTP接口在API.sms.cn平台上进行短信发送的相关操作,适用于国内的接口调用,包括了身份验证、字符编码、响应格式以及多种发送方式。以下是关键知识点的详细介绍: 1. 接口认证: 使用HTTP协议,第三方开发者需要通过用户名和密码进行身份验证。密码验证是将登录密码与用户名拼接后通过MD5加密实现的。开发者需要在请求中提供MD5加密后的32位密码,例如,如果登录密码是"123123",用户名是"test",计算出的密码会是"b9887c5ebb23ebb294acab183ecf0769"。 2. 字符编码: 支持两种字符编码,服务器默认接收UTF-8编码的数据,但如果发送的是GBK编码字符,需要在请求参数中添加encode=gbk,确保数据的正确解析。 3. 响应格式: 接口的响应结果支持JSON、XML和纯文本三种格式,但默认情况下返回的是JSON格式。每次请求成功后,服务器都会返回一个响应值,提供必要的信息。 4. 短信发送: 发送短信的操作通过GET或POST请求完成,基本格式为: ``` http://api.sms.cn/sms/?ac=send&uid=用户账号&pwd=MD5密码&mobile=手机号码&content=短信内容 ``` 其中,`ac`参数用于指定接口功能,传入`send`表示发送短信;`uid`是用户账号;`pwd`是加密后的密码;`mobile`是接收短信的电话号码,`content`则是预设的短信内容。 5. 短信模板: 文档还提到了JSON变量模板发送和全文变量模板发送两种方式,这允许开发者使用预定义的模板动态填充内容。此外,还有一种一对一多条发送的选项,可能是在批量发送时使用的。 6. 状态报告: 支持主动获取和推送接收短信发送状态报告,这对于监控和跟踪短信发送进度非常重要。 7. 上行短信处理: 用户可以主动获取和推送接收来自接收者的短信回复,这对于双向通信的应用来说必不可少。 8. 其他功能: 提供了查询剩余短信条数、已发送总条数、发送记录、修改密码、添加短信模板、查看模板审核状态、获取模板记录以及接口安全绑定IP等操作。 这份文档为开发者提供了全面的指导,从接口的基础配置到高级功能的使用,对于构建基于HTTP的短信发送系统非常实用。