中网短信接口需求.doc

龙卷风短信接口说明书 Ver：2.0 WebService接口 Tip：数据提交中文编码方式为UTF-8 URL：65/LiveVers/WebAsistSvc.asmx 校验用户 功能描述：校验用户是否有效 函数名称： validateUser 参数说明： 类别 参数名称 类型 说明 输入 username string 用户名称 输入 password string 用户密码 【=8位字母、数字构成】 返回值 返回值 解释 1 为本接口有效用户 -1 无效用户 (用户不存在， 密码错误或者用户被暂停) 查询余额 功能描述：获取用户当前短信剩余条数 函数名称：getRemain 参数说明： 类别 参数名称 类型 说明 输入 username string 用户名称 输入 password string 用户密码 【=8位字母、数字构成】 返回值 返回值 解释 大于等于0 用户当前短信剩余条数 -1 无效用户 短信发送 功能描述：短信发送 函数名称： sendSms 参数说明： 类别 参数名称 类型 说明 输入 username string 用户名称 输入 password string 用户密码 【=8位字母、数字构成】 输入 message string 短信内容,最多210个字符，超出70个字符，按每条67个字符自动拆分 输入 mobiles string 目的号码 (多个号码用逗号或分号分隔，为提高响应速度，每批次号码条数=15000) 返回值 返回值 解释 大于0 发送成功，返回任务号 -1 余额不足 -2 帐号或密码错误 -3 连接服务商失败 -4 超时 -5 其他错误，服务器错误 -6 短信内容为空 -7 目标号码为空 -8 短信内容超过210个字符 -11 号码格式无效 修改密码 功能描述：修改用户密码 函数名称：modifyPass 参数说明： 类别 参数名称 类型 说明 输入 username string 用户名称 输入 password string 用户旧密码 【=8位字母、数字构成】 输入 newpassword string 用户新密码 【=8位字母、数字构成】 返回值 返回值 解释 1 修改密码成功 -1 无效用户或者密码错误 Http Get接口 Tip：数据提交中文编码方式为UTF-8 Http URL：65/LiveVers/smsgate.aspx URL 中文字串请转成UTF-8编码， “中文” 编码后应为：“%E4%B8%AD%E6%96%87” 参数格式：svc=函数名参数列表..... 函数名、参数列表的要求跟WebService接口相同，参数不区分大小写，实例如下： 返回值：请参考前边WebService接口返回值，另外增加以下针对Get接口的错误码： 返回值 解释 -90 重复提交Http请求! -99 未知的服务名,svc赋值错误 -100 服务器异常，通常由于给定的参数不符合要求，缺少参数或参数名不正确 校验用户 示例： 65/LiveVers/smsgate.aspx?svc=validateUserusername=abcpassword=123 查询余额 示例： 65/LiveVers/smsgate.aspx?svc=getRemainusername=abcpassword=123 短信发送 示例： 65/LiveVers/smsgate.aspx?svc=sendSms username=abcpassword=123message=%E4%B8%AD%E6%96%87...mobiles13012345679... 注意： 1.参数[message]内容请用UTF-8编码 2.Get接口由于Http协义自身的限制，不要传大数据报，号码列表不要超过500个每请求 修改密码 示例： 65/LiveVers/smsgate.aspx?svc=modifyPassusername=abcpassword=123newpassword=111 4