飞扬短信平台二次开发接口V2.0规范

"飞扬短信平台二次开发接口规范HTTP接口 Version V2.0" 飞扬企业短信平台提供的短信网关接口是一个基于HTTP语言编写的二次开发接口，主要用于企业与电信通道的交互，实现短信的发送、状态查询、余额查询等功能。这个接口具有较高的通道容量，能够达到300条/s的处理速度，满足企业高效发送短信的需求。 一、发送短信 接口调用的核心函数为`xSendMessSMS.asp`，需要传递的参数包括： 1. `UserID`：用户的唯一标识 2. `Password`：用户密码，用于身份验证 3. `Phones`：接收短信的电话号码列表，多个号码用逗号分隔 4. `SMSs`：短信内容 返回码包含了多种状态，例如： - 0：发送成功，并返回发送ID用于后续状态查询 - -1：用户权限验证失败 - -2：用户短信余额不足 - -3：电话号码参数错误 - -4：短信内容超过69个字符（普通短信限制） - -5：长短信内容超过300个字符 - -6：系统错误 - -7：未知错误 - -8：短信内容包含非法内容 - -9：内部错误 二、获取短信发送余量 通过调用`xGetSMSStock.asp`，可以获取用户当前的短信余量。输入参数包括`UserID`和`Password`，返回值为整数，表示短信余额。如果返回-1，表示用户权限验证失败；返回-7则表示未知错误。 三、状态报告接收 为了接收短信发送状态报告，合作方需要提供一个HTTP接收地址。接口参数包括`userid`和`report`，其中`report`字段包含多条状态报告，每条报告由消息编号、手机号码和状态报告状态组成，各元素之间用逗号和分号分隔。 例如，一条状态报告可能如下所示： ``` 110925172456323,13882768136,DELIVRD;110925213202230,13124569889,DELIVRD ``` 这里的`DELIVRD`表示短信已成功送达。 总结起来，飞扬短信平台的二次开发接口为企业提供了高效、灵活的短信服务，支持批量发送、状态追踪和余额查询。通过这个接口，企业能够集成短信功能到自己的系统中，实现自定义的短信服务需求。然而，正确使用接口并处理各种返回状态码对于确保服务的稳定性和可靠性至关重要。