通用短信发送系统webservice接口

msg 返回值 描述 0 失败 1 发送成功 101 系统错误 102 无该企业或者密码错误,或者企业，密码为空 103 企业被禁用 104 业务错误 105 余额不足 106 IP限制 107 系统繁忙 108 非法词组 109 手机黑名单 999 发送失败 111 手机格式错误 112 手机号码为空 113 发送内容为空 114 发送内容太长 115 Msg_id太长。 116 手机号码超过最大值。 ### 通用短信发送系统Webservice接口知识点解析 #### 一、接口概述 本文档主要介绍了一个通用短信发送系统的Webservice接口实现方式。该系统通过提供一个标准的WebService接口，允许外部系统通过调用该接口来实现短信的发送及余额查询等功能。 #### 二、短信发送接口 **接口URL:** `http://www.XXXXX.com/gwi/services/service?wsdl` **接口方法:** `sendMsg(corpId, pwd, mobiles, content)` **接口参数说明:** - **corpId:** 企业账号，用于标识发送短信的企业身份。 - **pwd:** 密码，与企业账号配合使用，确保接口的安全性。 - **mobiles:** 手机号码，支持批量发送，多个手机号码之间使用英文逗号(,)分隔，一次最多可提交50个手机号码。 - **content:** 发送的短信内容，最多支持140个字符，采用UTF-8编码。 **返回信息说明:** `msg#count` - **msg:** 操作状态代码，根据不同的返回值代表不同的操作结果。 - **count:** 成功发送的短信条数。 **msg返回值描述:** - `0`: 发送失败。 - `1`: 发送成功。 - `101`: 系统内部错误。 - `102`: 不存在的企业账号或密码错误，也可能是企业账号或密码未填写。 - `103`: 企业账户已被禁用。 - `104`: 业务逻辑错误。 - `105`: 账户余额不足。 - `106`: IP地址被限制。 - `107`: 系统当前繁忙，请稍后重试。 - `108`: 发送内容包含非法词汇。 - `109`: 接收短信的手机号码在黑名单中。 - `999`: 其他未知错误导致发送失败。 - `111`: 提供的手机号码格式不正确。 - `112`: 未提供手机号码。 - `113`: 未提供发送内容。 - `114`: 发送内容长度超出限制（140字符）。 - `115`: Msg_id长度过长。 - `116`: 手机号码数量超出单次发送的最大限制（50个）。 #### 三、余额查询接口 **接口URL:** `http://www.XXXXX.com/gwi/services/service?wsdl` **接口方法:** `queryBalance(corpId, pwd)` **接口参数说明:** - **corpId:** 企业账号，用于标识查询余额的企业身份。 - **pwd:** 密码，与企业账号配合使用，确保接口的安全性。 **返回信息说明:** `msg#count` - **msg:** 操作状态代码，根据不同的返回值代表不同的操作结果。 - **count:** 当前账户的短信余额。 **msg返回值描述:** 余额查询接口的msg返回值与短信发送接口相同，具体含义如上所述。 #### 四、总结 本文档详细介绍了通用短信发送系统的Webservice接口实现方式，包括短信发送接口和余额查询接口的使用方法、参数说明以及返回值的解释。通过对这些知识点的理解，开发者可以轻松地集成此服务到自己的应用中，从而实现短信的批量发送和余额查询等功能。此外，通过了解不同返回值的含义，还可以及时发现并处理可能出现的问题，提高系统的稳定性和用户体验。