IMC对接三方短信平台,客户给了接口文档,这个是属于那种啦,自定义接入还是通用配置接入,咋用呢这个东西??
融 合 云 信 平 台
HTTP接口文档(V1.7.1)
联通在线
目录
4、JAVA版MD5签名程序参考................................................................................ 6
本文档适用于融合云信平台的HTTP方式接入的商户,正式接入之前需先在融合云信平台完成开通注册,申请HTTP能力,配置开通签名等工作。
通过联通沃云云市场入驻融合云信平台的商户,将自动开通HTTP能力,商户需在平台完成接入参数配置。
请求数据协议: HTTP POST
请求数据格式: JSON
请求数据编码: UTF-8
平台分配参数及获取方法:
参数 |
含义 |
获取途径 |
cpcode |
商户编码 |
登录自服务平台,进入商户信息页,【商户编码】值为cpcode |
key |
私钥 |
登录自服务平台,进入系统设置页,【AccessKey】值为key |
接口提供者:融合云信
接口地址:***.***:8000/umcinterface/sendtempletmsg
接口调用者:商户
接口请求参数:
字段名 |
字段类型 |
是否必须 |
说明 |
cpcode |
String |
必须 |
渠道在融合云信平台申请的cpcode 登录自服务平台,商户信息页面中的【商户编码】 |
msg |
String |
必须 |
模板参数值,如果包含多个参数,以半角英文逗号分隔 |
mobiles |
String |
必须 |
11位手机号,如果包含多个手机号,请用半角英文逗号分隔,最多支持300个手机号 |
excode |
String |
必须 |
渠道自定义接入号的扩展码,可为空;为空时传空字符串”” |
templetid |
String |
必须 |
渠道在融合云信平台申请的模板短信ID |
sign |
String |
必须 |
MD5签名,签名字符串为cpcode+ msg+mobiles+excode+templetid+key,其中key为融合云信平台分配的私钥,将签名字符串用MD5加密后转换为小写字符串。 |
数据举例:
{"cpcode":"XXXXXX","msg":"183001,2,10010","mobiles":"18607714703,18648807841","excode":"00000","templetid":"2","sign":"20e90defeea6ea29e643bdd8a80b18e0"}
接口响应
字段名 |
字段类型 |
是否必须 |
说明 |
resultcode |
String |
必须 |
错误码,请参考下节《错误码说明》 |
resultmsg |
String |
必须 |
错误码说明,请参考下节《错误码说明》 |
taskid |
String |
必须 |
内部订单号,匹配状态报告使用 |
数据举例:
{"resultcode":0,"resultmsg":"成功",”taskid”:” C20511170688217”}
接口提供者:商户
接口地址:商户在自服务平台中报备
接口调用者:融合云信
接口说明:状态报告数据以JsonArray格式批量发送,每次最大同时发送100条状态报告。
接口请求参数:
字段名 |
字段类型 |
是否必须 |
说明 |
state |
String |
必须 |
短信发送的状态报告码,0:成功,其余失败 |
mobile |
String |
必须 |
11位手机号码 |
taskid |
String |
必须 |
内部订单号,匹配状态报告使用,字母和数字的混合 |
sortid |
String |
必须 |
消息序号 |
time |
String |
必须 |
短信状态报告到达时间,格式为yyyyMMddHHmmss |
数据举例:
[{"mobile":"18607714703","state":"1","taskid":"T20511170688217",”sortid”:”0”,"time":"20170119140121"},{"mobile":"18607714704","state":"1","taskid":"T20511170688218",”sortid”:”0”,"time":"20170119140121"}]
接口响应
字段名 |
字段类型 |
是否必须 |
说明 |
status |
Int |
是 |
成功收到通知响应 0;异常1 |
样例:
{
"status": 0
}
接口提供者:商户
接口地址:商户在自服务平台中报备
接口调用者: 融合云信
接口说明:上行数据以JsonArray格式批量发送,每次最大同时发送100条状态报告。
接口请求参数:
字段名 |
字段类型 |
是否必须 |
说明 |
fisp |
String |
必须 |
上行端口号 |
mobile |
String |
必须 |
11位手机号码 |
msg |
String |
必须 |
上行短信内容 |
time |
String |
必须 |
短信上行时间,格式为yyyyMMddHHmmss |
数据举例:
[{"mobile":"18607714703","fisp":"10655512445223","time":"20170119140121","msg":"TD5"},{"mobile":"18607714704","fisp":"10655512445224","time":"20170119140121","msg":"TD5"}]
接口响应
字段名 |
字段类型 |
是否必须 |
说明 |
status |
Int |
是 |
成功收到通知响应 0;异常1 |
样例:
{
"status": 0
}
错误码 |
错误码说明 |
0 |
成功 |
301 |
JSON的格式错误 |
302 |
非法商户信息 |
304 |
缺少cpid参数 |
305 |
商户状态异常 |
306 |
商户能力异常 |
307 |
模板参数值不足 |
308 |
缺少msg参数 |
309 |
msg长度非法 |
310 |
包含敏感词 |
311 |
缺少mobiles参数 |
312 |
mobiles长度非法 |
313 |
缺少excode参数 |
314 |
缺少templetid参数 |
315 |
缺少sign参数 |
316 |
签名校验不通过 |
317 |
程序异常 |
package com.hello.test;
import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
public class MD5 {
public MD5() {
}
public static String makeMD5(String plainText) {
String re_md5 = new String();
try {
MessageDigest md = MessageDigest.getInstance("MD5");
md.update(plainText.getBytes("UTF-8"));
byte b[] = md.digest();
int i;
StringBuffer buf = new StringBuffer("");
for (int offset = 0; offset < b.length; offset++) {
i = b[offset];
if (i < 0)
i += 256;
if (i < 16)
buf.append("0");
buf.append(Integer.toHexString(i));
}
re_md5 = buf.toString().toLowerCase();
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
} catch (UnsupportedEncodingException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return re_md5;
}
public static void main(String[] args) {
String cpcode = "AAAAAC";
String msg = "模板短信测试,0001";
String mobiles = "18607714703,18648807841";
String excode = "";
String templetid = "2";
String key = "f75b9467e1112239";
String md5source = cpcode+ msg+mobiles+excode+templetid+key;
String md5str = "";
try {
md5str = makeMD5(new String(md5source.getBytes("UTF-8"), "UTF-8")).toLowerCase();
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
System.out.println(md5str);
}
}
无线短信认证使用
(0)
亲~登录后才可以操作哦!
确定你的邮箱还未认证,请认证邮箱或绑定手机后进行当前操作
举报
×
侵犯我的权益
×
侵犯了我企业的权益
×
抄袭了我的内容
×
原文链接或出处
诽谤我
×
对根叔社区有害的内容
×
不规范转载
×
举报说明
那这种配置的时候就是自定义配置是吗?需要定制啥呢具体?
定制短信模块呗,要么买IMC平台适配过的短信平台的产品 如亿美的短信包