简版HTTP协议接口文档0407Word文档下载推荐.docx

1、5. 1.22015/3/164修改的字段，从变为逗号分隔的，但 响应仍保持数组形式2015/3/19正式稿1 概述2 2.1 协议说明2.2 本短信是使用并遵循原则设计的服务接口，可以使用几乎任何客户端和任何编程语言与 进行交互。通过发送简单的 请求就可以轻松接入使用。2.3 版本说明2.4 在作为变体的协议1.0推出后，为了简化协议开发难度，对协议的下行和上行部分进行相应地修改，形成本简化协议，保留业务逻辑必要的核心字段，去掉扩展功能的若干字段（本接口不再具备发送数据短信能力）。 1.1与1.0的异同：1. 安全认证方式相同，仍然为报文头携带信息64编码，携带5 2. 下行上行报文简化3.

2、 状态报告推送方式保持不变4. 短信内容传递方式不使用,而是使用64编码的原始8字符串进行传递。2.5 适用范围2.6 2.7 参考资料2.8 1.0 2.9 缩略语缩写全称说明 企业客户短信下行短信上行3 通信方式4 通信支持 / 。其中 报文为作为请求平台 报文为平台作为客户端请求5 协议说明6 6.1 报文域属性说明6.2 元素约束（出现次数）符号说明：符号?0.1，可选项*0，可以没有，也可以有多项+1，至少有1项，也可以有多项必须有且只有1项6.3 请求平台（下行）统一格式6.4 6.4.1 平台 6.4.2 由平台提供:/属性约束类型描述平台的地址或者域名。端口号，端口号不为80时

3、，与用半角:隔开当端口号为80时，此字段可空协议版本，当前协议版本为：12示例：6.4.3 业务格式6.4.4 注： 与业务相拼接为完整请求帐号鉴权：/举例：下发短信息的为：用户0001查询账户余额的为： 0001业务功能用户6.4.5 标准包头字段6.4.6 包头必填字段：;8;客户端响应接收数据格式：类型： 8内容长度6.5 平台做客户端请求（上行）统一格式6.6 适用于平台作为客户端向发送上行、状态报告时的情形6.6.1 客户提供上行 6.6.2 由提供用以接收上行消息和状态报告的 提供上行为：6.6.3 上行业务完整6.6.4 上行各业务都有各自的，完整的业务会发送至：$客户提供上行

4、/平台上行短信为, 上行报文会发送至：平台状态报告为6.7 编码6.8 编码统一使用87 协议报文定义8 8.1 消息报文定义8.2 8.2.1 下行短消息8.2.2 8.2.2.1 提交短信方法$参见3.2节说明消息体帐号密码：（可以明文密码或使用32位5加密）（24）客户流水号，可在响应中携带返回，最长24位，可包含数字字母短信接收端手机号码集合，用半角逗号（英文逗号）分开，每批发送的手机号数量不得超过不能超过客户设置带宽。通常以20个号码做为上限。手机号建议不重复，不强制限制。短信内容，8编码字符串，单条通常为65汉字以内（根据签名规则不同），超过限制字数会被分拆，同时计费条数会根据最终

5、拆分条数计算，具体由平台拆分结果确定。 : 8 ,00001您的验证码为1234 【】响应消息：响应码响应短语200/401接收完成/鉴权失败下发接收完成时（200 ）：结果返回集合，每个提交手机号对应以下子元素子元素下行响应码取值见附录- 子元素 信息标识，用于对应状态报告用户提供流水号时：系统流水号+“-”+用户流水号用户未提供流水号时：系统流水号响应码不成功时无此内容手机号返回报文示例： 0, , 鉴权失败时（401 ）：报头 :值8.2.3 查询当前预付费用户余额8.2.4 $ 查询余额响应码？当前用户所属账户余额（响应吗为成功时存在）反馈示例：0 1008.2.5 上行验证8.2.6

6、 客户提供上行8标识，内容固定为200接收完成接收完成时（200 ）：固定返回08.2.7 上行短信推送8.2.8 $客户提供上行 信息标识用户上行服务号用户手机号短信内容，8编码字符串报文示例：1谢谢！上行接收响应码8.2.9 上行状态报告推送 8.2.10 信息标识 对应响应中的服务号发送短信的应答结果000029 附录-码表10 10.1 认证返回码代码系统忙用户鉴权错误7鉴权错误9未知错误10.2 下行短信提交响应码成功手机号码在黑名单手机号码不在白名单短信内容中包含黑名单关键字手机号码未找到相应运营商配置5手机号码格式错误下发队列满 需客户重发发送超速 需客户重发10短信内容超长11预付费客户余额不足含有未报备关键字13下行消息携带号码超过限制（默认为商户1s最大带宽）10.3 查询余额响应码查询成功当前用户属于后付费客户当前用户未分配账户10.4 上行接收响应码失败10.5 状态报告 . （. ） a 不返回响应消息时的状态报告返回错误响应消息时的状态报告0000人工审核错误00对应下行短信提交响应码，表示系统内部模块处理失败返回码。客户侧处理方式同下行短信提交响应码。