国都Http新接口协议9008

国都高速接口文档北京国都互联科技有限公司地址：北京市海淀区西四环北路158号慧科大厦东区3层ABC室电话：[phone]传真：[phone]网址：消息发送接口规范(HTTP:9008)北京国都互联科技有限公司2013-12-26国都高速接口文档北京国都互联科技有限公司地址：北京市海淀区西四环北路158号慧科大厦东区3层ABC室电话：[phone]传真：[phone]网址：发送接口[Submit]......................................................................................................................33.1.1接口协议..................................................................................................................33.2发送接口/查询余额/GET[Submit/surplus]...............................................................................33.2.1接口协议.................................................................................................................33.2.2请求参数..................................................................................................................33.2.3应答内容.................................................................................................................43.2.4查询余额.................................................................................................................53.3转发接口[Deliver].....................................................................................................................63.3.1接口协议.................................................................................................................63.3.2接口命名.................................................................................................................63.3.3get方式.....................................................................................................................63.3.3post方式...................................................................................................................6国都高速接口文档北京国都互联科技有限公司地址：北京市海淀区西四环北路158号慧科大厦东区3层ABC室电话：[phone]传真：[phone]网址：一概述本接口规范定义了企信通短信平台（服务方）与客户系统（客户方）之间的数据传输协议及使用方法。通过这个接口规范可以实现客户系统(通过企信通)与手机终端之间的消息传送。单条短信最长支持70个字符（中英文统一安一个字符计算），超过70个字符，系统将按67个字符一条的方式拆分成多条。国都高速接口文档北京国都互联科技有限公司地址：北京市海淀区西四环北路158号慧科大厦东区3层ABC室电话：[phone]传真：[phone]网址：消息，是指由业务系统送到企信通短信平台,再转发到运营商的网关，并最终发送到手机终端上的文字信息。2.2上行消息上行消息又称MO消息，是指由手机终端发送至企信通短信平台并最终送到客户系统的文字信息。2.3状态报告状态报告是一条特殊上行消息，用于报告下行消息的投递情况。并不是每一条下行消息都会有对应的状态报告。状态报告：消息被送达到手机终端后返回的消息。国都高速接口文档北京国都互联科技有限公司地址：北京市海淀区西四环北路158号慧科大厦东区3层ABC室电话：[phone]传真：[phone]网址：发送接口[Submit]3.1.1接口协议企信通短信平台的短信发送接口协议使用HTTP协议，短信平台接口提供访问的URL，用户使用HTTP-POST方法发送请求并得到应答内容,用户作为短信平台的HTTP客户端，短信平台作为用户的HTTP服务器。提交时如果使用HTTP方法，则同步返回包中将包含msgid，用户接到状态报告时，可以根据这里的msgid对下行短信进行勾兑。3.2发送接口/查询余额/GET[Submit/surplus]此接口可实现单条短信发送，批量相同短信发送，批量个性化短信（多手机号，多内容）发送3.2.1接口协议提交时如果使用HTTPPost方法，则同步返回包中也将包含msgid，用户接到转发接口发来的状态报告时，可以根据这里的msgid对下行短信进行勾兑。功能接口名调用方式说明发送消息QxtFirewall接口查询余额surplus接口3.2.2请求参数在向短信平台发起调用请求时，需要提供下表所列参数：参数名称是否必须(1是0否)参数说明取值说明国都高速接口文档北京国都互联科技有限公司地址：北京市海淀区西四环北路158号慧科大厦东区3层ABC室电话：[phone]传真：[phone]网址：格式,为空表示立即发送ValidTime0消息存活有效期YYYYMMDDHHMMSS格式AppendID0附加号码见注1DesMobile1接收手机号集合1.发送单条消息时，此字段填写11位的手机号码。2.群发消息时，此字段为使用逗号分隔的手机号码串。3.每批发送的手机号数量不得超过500个Content1发送消息内容1.发送单条短信或群发相同内容短信时，此字段为编码后的发送内容。2.若个性化短信（多手机号，多内容）内容需要单独编码之后用逗号分开变成串。之后再对整个串进行2次编码。3.个性批量短信时，手机号和内容是顺序对应的，手机号个数和内容个数要相同注1：例如用户在企信通短信平台中的身份标识的为13，若附加号码为0000，则接收号码收到的短信显示为来自spnumber+13+0000,否则不填附加短信标识，则显示为spnumber+13。并且：spnumber+企信通短信平台的短信身份标识+AppendID的总长度不能大于20.注2：如果需要发送批量短信，则将手机号码用英文的逗号分隔填写进DesMobile字段，DesMobile字段包含的最多手机号不能超过500个。如超过则视为非法包丢弃。注3：短信内容（Content）发起请求前必须进行URL转码。例如对于短信内容为“中文短信abc”,转码过程（java语言）如下：Stringcontent=URLEncoder.encode(中文短信abc,GBK)Stringnewcontent=URLEncoder.encode(content,gbk);结果为：%25D6%25D0%25CE%25C4%25B6%25CC%25D0%25C5abc3.2.3应答内容参数值：响应状态,响应包id（当响应状态为成功时）例如：03，Z123456121011153166若失败，则只返回状态码国都高速接口文档北京国都互联科技有限公司地址：北京市海淀区西四环北路158号慧科大厦东区3层ABC室电话：[phone]传真：[phone]网址：例如：05响应状态表响应状态说明00批量短信提交成功01个性化短信提交成功02IP限制03单条短信提交成功04用户名错误05密码错误06个性化短信格式错误07发送时间有误08内容为空09手机号码为空10扩展号格式错误11余额不足-1服务器内部错误3.2.4查询余额获取短信剩余条数的GET方法请