浙江电信短信门户webservice接口协议--有状态版本（标准）.docVIP

浙江电信短信门户有网关返回状态webservice接口协议 文件状态：[√] 草稿[ ] 正式发布 [ ] 正在修改文件标识：interfaces-Webservice 当前版本：1.0 作 者完成日期：版本/状态作者参与者起止日期备注 内部已初审 1. 交易接口 4 1.1. WEBSERVICE协议 4 1.2. 短信门户接口地址 4 1.3. 编码类型 4 2. 接口方法 4 2.1. 发送短信方法sendMessages 4 2.1.1. 请求要素 4 2.1.2. 应答要素 5 2.2. 接收短信方法getMessages 5 2.2.1. 请求要素 5 2.2.2. 应答要素 6 2.3. 获取短信状态方法getAllStatus 6 2.3.1. 请求要素 6 2.3.2. 应答要素 6 3. 示例代码 7 3.1. 接口连接初始化 7 3.2. 发送 7 3.3. 接收 7 3.4. 获取状态 8 交易接口 WEBSERVICE协议 Webservice 的概念是使用一个标准的输出接口来定义代码提供的功能，以便让外界可以通过这个标准的输出接口来调用，而所谓的标准输出接口就是wsdl，wsdl是一个xml组成的文件，描述了实现程序对外提供函数的原型，客户端可以通过wsdl来调用实现程序提供的服务代码。 短信门户接口地址 :8181/axi 编码类型 UTF-8编码sendMessages 请求要素 字段名 字段含义 描述 关键域 username 企业主叫 （String 类型） 企业开户时的主叫号码 ★ pwd 帐号密码 （String 类型） ★ messages :短信包 （由短信目的号码和短信内容组成，string类型） 消息ID是标识此条消息的唯一ID！ 发送模式：1 主叫；2轮换 ★ 短信包结构图： 短信基本单元1 /r/n/ 短信基本单元2 /r/n/ 短信基本单元3 /r/n/ …… 短信基本单元结构体：： 消息ID（唯一） /%/$/ 接收号码 /%/$/ 发送模式 /%/$/ 发送内容 （短信包示例：1/%/$/×××/%/$/1/%/$/下行短消息测试/r/n/2/%/$/×××/%/$/2/%/$/下行短消息测试/r/n/……） 注：短信包结构体最大包含100条短信，每条短信的短信内容最好控制在250个字以内！ 如果对移动、联通用户做大批量短信发送时，建议发送模式改为2，避免被拦截，提高短信成功率 消息ID ——NUMBER类型，14位数字以内 应答要素 字段名 字段含义 描述 关键域 resultString （string类型） 短信发送到短信平台的标识ID和状态（每条短信以”/r/n/”连接，标识id和状态之间以”/%/$/”连接，返回状态代表的意思 ：0—成功，1—号码错误，2—敏感字符，3—流量超出，4—主叫号码或密码错误），5---提交短信包格式错误 ★ 短信包返回状态结构图： 短信状态1 /r/n/ 短信状态2 /r/n/ 短信状态3 /r/n/ …… 短信状态结构图： 消息ID（唯一） /%/$/ 短消息提交状态 例如：12345/%/$/0/r/n/12346/%/$/2/r/n/ 表示短信ID为12345短信提交成功，12346的短信提交失败（短信内容包含关键字） 接收短信方法getMessages 注意：请求短信不低于10秒的间隔 请求要素 字段名 字段含义 描述 关键域 username 企业主叫 （String 类型） 企业开户时的主叫号码 ★ pwd 帐号密码 （String 类型） ★ 应答要素 字段名 字段含义 描述 关键域 Messages 短消息包 （string类型） 平台返回的批量短信包 ★ Messages消息体说明: 上行短信包结构图如下： 短信1 /r/n/ 短信2 /r/n/ 短信3 /r/n/ …… 图2 上行短信结构图如下： 发送方号码 /%/$/ 短信内容 /%/$/ 接收时间 图3 上行短信消息包，上行短信消息包中的每条上行短信用“/r/n/”分隔（例如：短信1/r/n/短信2/r/n/短信3/r/n/），每条上行短信包括3个组成部分，分别为：短信发送方号码，发送内容，发送时间，每个部分用“/%/$/”分隔（例如：×××/%/$/上行短信接收测试/%/$/×××）。上行短信包与上行短信的结构图见图2，图3所示。 获取短信状态方法getAllStatus 注意：获取短信状态的间隔时间应不低于30秒 请求要素 字段名 字