# DEMO示例
# 服务场景描述
邮件短信服务通过调用发送邮件API、发送短信API完成邮件短信的发送功能，满足产品通过短信和邮件形式实现通知的需求。
# 服务调用流程
# 1.本服务调用依赖以下API
# 2.服务调用前置条件
创建应用,获取appkey、appsecret；
获取服务调用token；
开通服务，scope授权通过；
以上步骤可参考前置准备
创建邮件、短信模板，获取模板id；
获取邮件、短信模板操作：1、登录AECORE；2、开通邮件短信服务；3、创建邮件、短信模板
示例图1：创建短信模板
示例图2：创建邮件模板
示例图3：模板创建后，默认状态为“审批中”，需要等待审批，审批后状态变为“使用中”后，即可正式使用
# 3.具体调用步骤
step1：maven依赖
<!--使用公司公共maven仓库（packages.glodon.com）,引用配置登录仓库搜索即可。本地项目涉及到该sdk版本冲突时可能需要手动解决版本控制问题-->
<dependency>
<groupId>com.glodon.paas.colibri</groupId>
<artifactId>colibri-core</artifactId>
<version>2.1.1-SNAPSHOT</version>
</dependency>
1
2
3
4
5
6
2
3
4
5
6
step2：实例化ColibriSDK
ColibriSDK client = new ColibriSDK();
//用户中心地址
client.setAccountServerUrl("https://account.glodon.com");
//发送邮件地址，需要时设置
client.setApiColibriUrlEmail("https://apigate.glodon.com/colibri/api/email");
//发送短信地址，需要时设置
client.setApiColibriUrlSms("https://apigate.glodon.com/colibri/api/security/sms");
//发送企业微信群消息地址，需要时设置
client.setApiColibriUrlQywx("https://apigate.glodon.com/colibri/api/qywx");
//申请到的应用appkey，与申请模板的appkey保持一致
client.setAppKey(appKey);
//申请到的应用appsecert
client.setAppSecret(appSecret);
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
step3：邮件发送服务调用
//邮件发送
EmailMessage msg = new EmailMessage();
//收件人地址列表
msg.setTo(new String[]{"XXX@glodon.com"});
//html方式发送
msg.setHtml(true);
//收件模板
msg.setTemplateId("XXXX_zh_CN");
//模板参数变量
Map<String, Object> params = new HashMap<String, Object>();
params.put("password", "11");
params.put("adminEmail", "http://www.baidu.com");
msg.setParams(params);
client.sendEmail(msg, true);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
step4：短信发送服务调用
//短信发送
SmsMessage msg = new SmsMessage();
msg.setMobiles(new String[]{"188XXXXXXXX"});
//短信模板
msg.setTemplateId("author_verification_sms");
//模板参数变量
Map<String, Object> params = new HashMap<String, Object>();
params.put("password", "11");
params.put("adminEmail", "http://www.baidu.com");
msg.setParams(params);
client.sendSms(msg, true);
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
step5：企业微信群消息发送服务调用
//企业微信群消息发送
QywxMessage msg = new QywxMessage();
msg.setRobotKey("693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa");//假设webhook是：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa
//消息类型
msg.setMsgtype("text");
//消息内容
msg.setText(new QywxInnerContent());
msg.getText().setContent("北京今日天气：29度，大部分多云，降雨概率：60%");
client.sendQywx(msg, true);
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 演示代码
public static void main(String[] args) throws Exception {
ColibriSDK client = new ColibriSDK();
//用户中心地址
client.setAccountServerUrl("https://account.glodon.com");
//发送邮件地址，需要时设置
client.setApiColibriUrlEmail("https://apigate.glodon.com/colibri/api/email");
//发送短信地址，需要时设置
client.setApiColibriUrlSms("https://apigate.glodon.com/colibri/api/security/sms");
//发送企业微信群消息地址，需要时设置
client.setApiColibriUrlQywx("https://apigate.glodon.com/colibri/api/qywx");
//申请到的应用appkey，与申请模板的appkey保持一致
client.setAppKey(appKey);
//申请到的应用appsecert
client.setAppSecret(appSecret);
//1.邮件发送
EmailMessage msg = new EmailMessage();
//收件人地址列表
msg.setTo(new String[]{"XXX@glodon.com"});
//html方式发送
msg.setHtml(true);
//收件模板
msg.setTemplateId("XXXX_zh_CN");
//模板参数变量
Map<String, Object> params = new HashMap<String, Object>();
params.put("password", "11");
params.put("adminEmail", "http://www.baidu.com");
msg.setParams(params);
client.sendEmail(msg, true);
//2.短信发送
SmsMessage msg = new SmsMessage();
msg.setMobiles(new String[]{"188XXXXXXXX"});
//短信模板
msg.setTemplateId("author_verification_sms");
//模板参数变量
Map<String, Object> params = new HashMap<String, Object>();
params.put("password", "11");
params.put("adminEmail", "http://www.baidu.com");
msg.setParams(params);
client.sendSms(msg, true);
//3.企业微信群消息发送
QywxMessage msg = new QywxMessage();
msg.setRobotKey("693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa");//假设webhook是：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa
//消息类型
msg.setMsgtype("text");
//消息内容
msg.setText(new QywxInnerContent());
msg.getText().setContent("北京今日天气：29度，大部分多云，降雨概率：60%");
client.sendQywx(msg, true);
}
1
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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52