国都Http新接口协议9008分析.docVIP

消息发送接口规范 (HTTP:9008)  北京国都互联科技有限公司 2013-12-26  目 录 一 概述 1 2 2.1 下行消息 2 2.2 上行消息 2 2.3 状态报告 2 三 HTTP方法 3 3.1发送接口[Submit] 3 3.1.1接口协议 3 3.2发送接口/查询余额/GET [Submit/surplus] 3 3.2.1 接口协议 3 3.2.2请求参数 3 3.2.3 应答内容 4 3.2.4 查询余额 5 3.3 转发接口[Deliver] 6 3.3.1 接口协议 6 3.3.2 接口命名 6 3.3.3get方式 6 3.3.3post方式 6 一 概述 本接口规范定义了企信通短信平台（服务方）与客户系统（客户方）之间的数据传输协议及使用方法。通过这个接口规范可以实现客户系统(通过企信通)与手机终端之间的消息传送。 短信70个字符（）超过70个字符，系统将按67个字符一条的方式拆分成多条。 二 消息定义 2.1 下行消息 下行消息又称MT消息，是指由短信平台到短信平台三 HTTP方法 3.1发送接口[Submit] 3.1.1接口协议 企信通短信平台的短信发送接口协议使用HTTP协议，短信平台接口提供访问的URL，用户使用HTTP-POST方法发送请求并得到应答内容,用户作为短信平台的HTTP客户端，短信平台作为用户的HTTP服务器。提交时如果使用HTTP方法，则同步返回包中将包含msgid，用户接到状态报告时，可以根据这里的msgid对下行短信进行勾兑。 3.2发送接口/查询余额/GET [Submit/surplus] 此接口可实现单条短信发送，批量相同短信发送，批量个性化短信（多手机号，多内容）发送 3.2.1 接口协议 提交时如果使用HTTP Post方法，则同步返回包中也将包含msgid，用户接到转发接口发来的状态报告时，可以根据这里的msgid对下行短信进行勾兑。 功能 接口名 说明 发送消息 QxtFirewall 58:9008/HttpQuickProcess/submitMessageAll 接口 查询余额 surplus 58:8081/QxtSms_surplus/surplus 接口 3.2.2请求参数 在向短信平台发起调用请求时，需要提供下表所列参数： 参数名称 是否必须 (1是0否) 参数说明 取值说明 OperID 1 业务标识 已开通的帐号名称 OperPass 1 操作密码 与帐号名称对应的密码 SendTime 0 发送时间 YYYYMMDDHHMMSS格式,为空表示立即发送 ValidTime 0 消息存活有效期 YYYYMMDDHHMMSS格式 AppendID 0 附加号码 见注1 DesMobile 1 接收手机号集合 1.发送单条消息时，此字段填写11位的手机号码。 2.群发消息时，此字段为使用逗号分隔的手机号码串。 3.每批发送的手机号数量不得超过500个 Content 1 发送消息内容 发送单条短信或群发相同内容短信时，此字段为编码后的发送内容。 2.若个性化短信（多手机号，多内容）内容需要单独编码之后用逗号分开变成串。之后再对整个串进行2次编码。 3.个性批量短信时，手机号和内容是顺序对应的，手机号个数和内容个数要相同 注1：例如用户在企信通短信平台中的身份标识的为13，若附加号码为0000，则接收号码收到的短信显示为来自spnumber+13+0000,否则不填附加短信标识，则显示为spnumber+13。并且：spnumber+企信通短信平台的短信身份标识+ AppendID的总长度不能大于20. 注2：如果需要发送批量短信，则将手机号码用英文的逗号分隔填写进DesMobile字段，DesMobile字段包含的最多手机号不能超过500个。如超过则视为非法包丢弃。 注3：短信内容（Content）”,转码过程（java语言）如下： String content=URLEncoder.encode(中文短信abc,GBK) String newcontent = URLEncoder.encode(content, gbk); 结果为：%25D6%25D0%25CE%25C4%25B6%25CC%25D0%25C5abc 3.2.3 应答内容 参数值：响应状态,响应包id（当响应状态为成功时） 例如：03，若失败，则只返回状态码 例如：05 响应状态表 响应状态 说明00 批量短信提交成功 01 个性化短信提交成功 02 IP限制 03 单条短信提交成功 04 用户名错误 05 密码错误 06