前提条件
- 到如下网址注册聚合数据账户https://www.juhe.cn/
- 登录后进入个人中心进行企业认证
- 认证成功后通过如下网址申请短信接口https://www.juhe.cn/docs/api/id/54
- 等待接口审核通过后你会得到一个接口的appkey
配置框架参数
在src.resource下面有一个juhedata_config.xml的配置文件
<?xml version="1.0" encoding="UTF-8"?>
<juheconfig>
<sms appkey="//TODO" url="http://v.juhe.cn/sms/send"></sms>
<phone-owner appkey="//TODO" url="http://apis.juhe.cn/mobile/get"></phone-owner>
</juheconfig>
配置文件解释
参数名称 | 是否必须 | 参数解释 |
---|---|---|
sms | 是 | 短信接口配置节点 |
appkey | 是 | 申请到的短信接口appkey |
url | 是 | 短信接口调用地址,默认http://v.juhe.cn/sms/send |
你只需要把申请到的短信接口的appkey配置到sms节点的appkey属性就可以了
注意这个配置文件中还有phone-owner的配置节点,这个是获取手机号码归属地的接口配置,会在其他文档对此进行说明。
代码调用
使用方法
com.base.common.util.transport.juhe.JuheSMSAPI.getInstance().sendMessage(String tempId,String phoneNumber,Map<String,Object> params)
参数解释
- tempId
在申请到短信接口后,是不能想发什么短信就发什么短信的 ,必须基于模板来发送,模板需要自己创建,并且需要聚合数据审核,通过审核后的模板会得到一个模板编号,这里的tempId就是传这个模板编号
- phoneNumber
短信接收者的电话号码,11位手机号码 - params
传递对应模板占位符的具体数据,聚合数据的占位符要以#开头并且以#结尾,如下#money# 和#balance#就是占位符
尊敬的用户您好,您已成功充值#money#元,当前余额为#balance#元。
这时候你应该组装的params参数如下
Map<String,Object> params = new HashMap<String,Object>();
params.put("money",1000);
params.put("balance",2000);
尊敬的用户您好,您已成功充值1000元,当前余额为2000元。