第1课短信订购及上行协议 - 任信了.docVIP

接口规范 （数字短信版） 武汉恒枫伟业科技有限公司 2016年06月 修订记录 版本号 修订人 修订日期 修订描述 V1.0 文档目录 文档目录 3 1. 概述 4 1.1. 编写目的 4 1.2. 术语定义 4 1.3. 协议约定 4 1.4. 命名约定 5 1.5. 安全规范 5 IP鉴权 5 Nonce验证 5 Sign签名摘要 5 1数字短信发送 6 1.1 说明 6 1.2 接口方式 6 1.3 接口地址 6 1.4 请求参数 6 1.5 响应参数 7 1.6 示例 7 2 附件 7 数字短信状态列表 7 2.1 注意事项 8 概述 编写目的 本文档的编写目的是提供给合作方技术人员做通道接入和测试。 术语 说明 平台方 与服务 方 合作伙伴应用与服务 方 调用的发起 接收方 请求的 签名密钥 给合作伙伴的生成签名摘要的密钥AccessSecurityKey) 协议 通信协议 协议使用， 请求提交方式 POST和GET的方式提交。 请求提交编码 UTF-8。当以GET方式请求时，各参数的参数值需做URL编码，参数不需要URL编码。 地址 调用提供的接口中注明。 接口调用地址由提供 返回格式 接口返回 命名约定 请求地址、的规则，，注意 安全规范 平台方和合作方双方提供需要通讯的服务器，来安全。 N 随机参数随机算法或生成，最多由字符串并限定字符为大小写字母、、和下划线用于重放。nonce后的内不能重复。 签名请求签名）算法生成，接收方进行校验，伪造非法请求中被篡改 签名内容 签名内容包括接口定义中参数的值签名）进行（使用前的原始值）。 格式密钥|参数值|参数值|…”的格式，|”符号组装。组装密钥和参数值均字符串值为空字符串也按空字符串组装。 参数值顺序对应排序，参数键由字母、数字、下划线、中划线 签名算法 的签名内容，使用二进制数组然后算法，生成摘要时，将使用保存然后直接使用string)函数生成。 合作方和平台方在发送，均要签名摘要，请求参数。 接口方式 HTTP协议 POST方式、GET方式 接口地址 发送的URL地址为：:9999/smsgate/szdxsend.do? 请求参数 参数名称 类型 选取原则String 必选(URL方式编码为UTF-8格式) pwd String 必选 String 必选 mbbh String 必选 响应参数 用户短信通过http请求提交到服务器后，服务器返回响应码，响应码的格式如下：msgid,以半角逗号分隔，msgid为16位固定长度，单发返回一个msgid表示成功，群发返回多个msgid,msgid与提交号码相对应 示例 单发 :9999/ smsgate/szdxsend.do?user=1pwd=1phonebbh=123456 提交成功 014fe49a7e47001d,014fe49a7e47001a 提交失败 返回值 见附件6.2 4004 附件 数字短信状态列表 返回代码 代码说明 0 操作成功（操作成功返回0或者是相应的结果） 4002 2 操作失败 3 时间超限 4 用户登陆异常 5 流控超限 6 验签失败 7 序列异常 8 号码异常 9 内容异常或存在关键字 10 省份代码有误 11 数字短信不存在 12 用户没有调用权限 13 用户计费类型异常 14 用户条数不足 15 用户流量不足 16 时间异常 17 分页异常 18 当前数字短信不可删除 19 时间戳异常 20 标题异常 21 数字短信类型异常或未分配该类型 22 数字短信创建参数异常 23 上传文件后缀名非法 24 动态创建失败 25 数字短信参数超过上限值 26 数字短信附件异常 注意事项 1、分隔符固定为半角逗号 2、所有参数均为小写 任信了平台技术文档 武汉恒枫伟业科技有限公司 7 / 8