企信通20业务用户接口协议(http)v10

《企信通20业务用户接口协议(http)v10》由会员上传分享，免费在线阅读，更多相关内容在学术论文-天天文库。

1、北京移动企信通2.0系统消息发送接口规范(HTTP:9000)中国移动集北京有限公司2014-02-觀1二消'肩、奴22.1下行消息22.2上行消息22.3状态报告2三HTTP施33.1发送接口[Submit]33.1.1接□协议33.2发送接口/POST[Submit】33.2.1接□协议33.2.2请求参数43.2.3应答容43.3转发接门[Deliver]53.3.1接U协议53.3.2接□命名53.3.3post方式URL_TYPE=45一概述本接口规范定义了企信通2.0短信平台（服务方）与客户系统（客户方）之间的数据传输协议及使川方法

2、。通过这个接U规范可以实现客户系统（通过企信通）与手机终端之间的消息传送。单条短信最长支持70个字符（屮英文统一安一个字符计算），超过70个字符，系统将按67个字符一条的方式拆分成多条。二消息定义2.1下行消息下行消息又称MT消息，是指由业务系统送到企信通短信平台,再转发到运营商的网关，并最终发送到手机终端上的文字信息。2.2上行消息上行消息乂称M0消息，是指由手机终端发送至企信通短信平台并最终送到客户系统的文字信息。2.3状态报告状态报告是一条特殊上行消息，用于报告下行消息的投递情况。并不是每一条下行消息都会有对应的状态报告。状态报告：消息被

3、送达到手机终端后返In］的消息。三HTTP方法3.1发送接口[Submit]3.1.1接U协议企信通2.0短信平台的短信发送接口协议使用HTTP协议，短信平台接口提供访问的URL,用户使用HTTP-POST方法发送请求并得到应答内容，用户作为短信平台的HTTP客户端，短信平台作为用户的HTTP服务器。提交吋如果使用HTTP方法，则同步返回包屮将包含msgid，用户接到状态报告吋，可以根据这里的msgid对下行短信进行勾兑。3.2发送接口/POST[Submit]此接口可实现单条短信发送，批量相同短信发送，批量个性化短信（多手机号，多内界）发送3

4、.2.1接口协议提交时如果使用HTTPPost方法，则同步返回包中也将包含msgid，用户接到转发接口发来的状态报告时，可以根据这里的msgid对下行短信进行勾兑。功能接口名调用方式说明发送消息QxtFirewallhttp://221.179.180.150:9000/HttpTemp/submitMessageAll测试接口功能接口名调用方式说明发送消息QxtFirewallhttp://218.206.78.88:9000/HttpTemp/submitMessageAll生产接口3.2.2请求参数在向短信平台发起调用请求时，需要提供下表

5、所列参数:参数名称是否必须（1是0否）参数说明取值说明OperlD1业务标识己开通的帐兮名称OperPass1操作密码与帐号名称对应的密码SendTime0发送时间YYYY.M.MDDHILM.MSS格式，为空表示立即发送ValidTime0消息存活宥效期YYYYMMDDHHMMSS格式AppendID0附加号码扩展码DesMobile1接收手机号集合1.发送单条消息吋，此字段填写11位的手机号码。2.群发消息吋，此字段为使用逗号分隔的手机号码串。3.每批发送的于•机号数带不得超过500个Content1发送消息内容信息内容格式为：“参数1

6、参

7、数2

8、参数3

9、……”ModellD1短信模版标识为10位字符串注1:短信内容（Content）发起请求前必须进行URL转码。例如对于短信内容为“中文短信abc”，转码过程（java语言）如下:aa%D6%D0%CE%C4%B6%CC%D0%C5abc3.2.3应答内容响应状态表响应状态说明-1参数有误-2IP认证失败-4用户验证失败-5密码错误-7发送时间错误-8内容为空-9手机号为空-10扩展验证错误-11余额不足-16模板ID为空-17模板错误-18模板与内荇参数个数错误3.3转发接口[Deliver]3.3.1接口协议企信通2.0短信平台

10、的短信转发接口协议使用HTTP协议，第三方系统需要提供短信平台访问的URL,短信平台使用HTTPGET方法发送请求，第三方接门接到后只需给予其确认应答，短信平台认为处理结果必须成功，即第三方系统是否正确的处理了短信平台的转发请求，短信平台均不再重复转发该短信。第三方系统作为短信平台的HTTP服务器，短信平台作为第三方系统的HTTP客户端。3.3.2接□命名功能接口名调用方式说明转发消息deliverMessagehttp://ip:port/deliverMessage部署在客户系统注：http://ip:port/deliverMessage

11、仅为模拟，具体由客户提供系统向第三方系统发起调用请求时，调用请求提供下表所列请求参数:参数名称参数说明取值说明SmsType短信类型0:上行短信；1一