"企信通短信接口说明书提供了关于如何与企信通短信平台进行交互的详细指导,涵盖了发送接口、余额查询、非法关键词查询、状态报告和上行接口等多个功能。"
1. 发送接口
- 请求地址: 客户通过HTTP POST方法向`http://www.xxxxx.com/sms.aspx`发送请求来执行短信发送。
- 参数说明: 包括`userid`(企业ID)、`account`(发送用户帐号)、`password`(发送帐号密码)、`mobile`(接收号码列表)、`content`(短信内容)、`sendTime`(定时发送时间)和`action`(发送任务命令)等,其中`checkcontent`可选,用于检查内容是否包含非法关键词。
2. 余额及已发送量查询接口
- 请求地址: 未提供具体地址,但通常会有专门的URL用于查询账户余额和已发送短信数量。
- 参数说明: 可能包括`userid`和`account`等,用于验证身份。
3. 非法关键词查询
- 请求地址: 未提供具体地址,此接口用于查询短信内容中是否存在不允许的词汇。
- 参数说明: 可能需要提供`content`字段以检查其中的关键词。
4. 状态报告接口
- 请求地址: 未提供具体地址,用于获取短信发送状态报告。
- 参数说明: 可能包括`msgId`(消息ID)等,以便跟踪特定发送请求的状态。
- 返回值和错误返回值: 以XML格式返回,包括`returnstatus`字段表示状态,如“Success”表示成功,“Faild”表示失败。
5. 上行接口
- 请求地址: 未提供具体地址,此接口用于处理来自用户的回复或上行短信。
- 参数说明: 可能包含`mobile`(发送号码)和`content`(上行短信内容)等。
- 返回值和错误返回值: 同样以XML格式返回,用于确认接收和处理上行短信的成功与否。
企信通短信接口采用HTTP POST方法,编码方式为UTF-8。在发送请求时,客户需要按照规定的参数格式组织请求,并将响应解析为XML以获取操作结果。对于安全性和可靠性,密码等敏感信息应进行加密处理。同时,平台可能提供通知服务,当接口地址发生变化时,会及时通知接口用户。为了确保短信服务的正常运行,开发者需要理解和正确实现这些接口的每个细节。