亿星短信平台Post接口文档详解与调用要点

亿星短信平台Post接口文档详细介绍了亿星公司提供的短信业务能力引擎，该接口采用同步Web Service方式，便于应用开发商集成到其产品中，无需深入理解复杂的电信网络通信协议，简化了短信发送的功能调用。接口设计者陈胜良在2011年制定的规范中强调了接口的安全性，规定只支持POST方式提交数据，以保护用户信息的安全，避免GET方式可能导致的数据泄露。 接口地址为`http://59.175.148.83:9080/PlatBusi/SMSSendService`，并且在调用时需要提供以下关键参数： 1. **用户ID** (`user_id`)：由系统管理员开通的账号标识，确保权限控制。 2. **用户密码** (`user_pwd`)：由管理员设定的登录密码，用于验证身份。 3. **手机号码** (`mobile`)：目标用户的手机号，最多支持50个号码，每个号码间用英文逗号分隔。 4. **短信内容** (`msg_content`)：短信文本，长度限制为1000个字符（包括汉字、英文和阿拉伯字符），每个中文字符算作1个，建议控制在70字以下，群发时每条短信不超过65字，且不得包含`&`字符。 5. **自定义短信ID** (`corp_msg_id`)：用户指定的群发标识，长度不超过50字节，可为空。 发送速度方面，接口允许每秒最多10次请求，且有0.1秒的访问间隔。此外，接口对IP、编码格式、访问方式等都有具体要求，如指定IP发送、支持GBK编码等。若使用不当，可能遇到如余额不足、账号状态异常、短信内容不符合规范等问题，返回的错误代码和含义如下： - `0#数字`：表示提交成功，返回实际发送成功的手机数量。 - `100`：余额不足，无法完成发送。 - `101`：账号已关闭，无法发送短信。 - `102`：短信内容过长或为空或编码格式错误。 - `103`：手机号码数量超过限制或无有效号码。 - `104`：用户请求过于频繁，频率低于50毫秒。 - `105`：请求方式不是POST，接口拒绝。 - `106`：用户账号不存在或密码错误。 - `108`：指定访问IP错误。 - `110`：小号（特殊号码）不合法。 - `111`：短信内容包含敏感词汇，可能被拦截。 - `-100`：其他未知错误，可能需要进一步排查。 在使用亿星短信平台Post接口时，开发者需注意这些细节，确保合规并优化用户体验。长短信处理时，接口返回的是用户提交的条数，而非实际扣费条数，因此可能需要自行处理拆分发送的情况。