短彩中心短信平台第三方接入接口规范http协议_动态模板_静态模板_V1.0.doc

短彩中心短信平台 第三方接入接口规范 (http协议) 目录 1. 说明 2 1.1. 提交方式与编码 2 2. 主体协议 2 2.1. 静态模板发送短信 2 1.1.1 发送地址 2 1.1.2 发送参数说明 3 1.1.3 发送Json格式 3 1.1.4 响应参数说明 4 1.1.5 响应Json格式 4 2.2. 动态模板发送短信 5 1.1.1 发送地址 5 1.1.2 发送参数说明 5 1.1.3 发送Json格式 6 1.1.4 响应参数说明 6 1.1.5 响应Json格式 7 2.3. 附录：错误代码 7 说明 提交方式与编码 http post方式 UTF-8格式编码 主体协议 静态模板 发送地址 http:// /web-access/service/plain/putStaticSms 静态模板短信内容由运营平台管理并提供，调用方不能在接口中提供短信内容。需要先到运营平台查询短信模板编号，然后应用到接口调用中。 发送参数说明 请求参数说明： 参数名称 是否必须 数据类型 参数说明 body(content-Type) 是 varchar text/plain，详见“body消息参数说明” username 是 varchar 用户名 timestamp 是 long 时间戳 secretcode 是 varchar username + secret + timestamp md5加密 datatype 是 varchar 填写：json mosupport 是 varchar 是否要求支持上行，1 是 2 否 注： username，secret 由平台运营商提供 body消息参数说明 参数名称 是否必须 数据类型 参数说明 messages 是 JSON destination 是 varchar 手机号，发送目的地 priority 是 int 优先级， 0-9整型数 sequence 否 Number 序列号， 长整型，例：System.nanoTime() + (long)(new Random()).nextInt(99); template 否 Number 静态模板编号 发送Json格式 { messages: { destination: [ ], priority: 0, sequence: 21287075728581, template: 29382247443544 } } 响应参数说明 返回参数名称 是否必须 数据类型 返回参数说明 batchnumber 是 Number 批次号，长整型 code 是 int 1 发送成功 2发送失败 errorcode 是 Int 错误代码，见附录：错误代码 text 否 varchar 失败原因描述 successcount 是 Int 成功条数 message 是 详细描述每个信息失败原因，仅列出有失败内容的短信，当全部是成功或者全部失败时，该体为空；只有当有失败信息时，message中会列出失败内容 destination 是 Varchar 手机号 sequence 否 Varchar 流水号 errorcode 是 Int 错误代码，见附录：错误代码 text 否 Varchar 失败原因,如果destination不为空，得到其对应失败原因 响应Json格式 部分成功提示信息: { batchnumber: 27705058624187, code: 1, errorcode: 300, message: [ { destination: [ 666666666666, 89696565655 ], errorcode: [ 306 ], sequence: 105653539423640, text: } ], successcount: 2, text: 目的地无效[666666666666]|目的地无效[89696565655] } 全部成功或失败提示信息: { batchnumber: 2770505862