JAVA调用云平台短信验证接口

1 创建子账号

1.1 功能

客户侧发起请求，云通讯平台收到请求后，返回子账户信息。

1.2 组包

构造请求URL内容：
  • 获得系统时间戳；
  • 拼接sig字符串，格式为“主账户id + 主账户授权令牌 + 时间戳 ”； 
  • 使用MD5加密sig字符串；
  • 拼接URL内容；

构造请求头信息 ：
  • 设置Accept项为“application/xml”；
  • 设置 Content-Type项为“application/xml;charset=utf-8”；
  • 设置Authorization 项，先拼接字符串“主账户ID + 冒号 + 时间戳”，冒号为英文格式，再将字符串进行Base64编码。

构造Body ：
 • 拼接XML格式字符串，字段包括应用id、子账户名称、主账户id、子账户类型、子账户状态。  

1.3 代码

/**
* @brief 创建子账号
* @param accountSid 主账号
* @param authToken 主账号令牌
* @param appId 应用id
* @param friendlyName 申请的邮箱
* @param type 类型
* @param status 状态
* @return Httppost 协议包封装
* @throws NoSuchAlgorithmException
* @throws KeyManagementException
*/
public String CreateSubAccount(String accountSid, String authToken, String appId, String friendlyName,
String type, String status) throws NoSuchAlgorithmException, KeyManagementException {
// 返回的响应字符串
String result = "";
// 创建HttpClient
CcopHttpClient chc = new CcopHttpClient();
DefaultHttpClient httpclient = chc.registerSSL("app.cloopen.com",
"TLS", 8883, "https");
try {
// 构造请求URL内容
String timestamp = DateUtil.dateToStr(new Date(), DateUtil.DATE_TIME_NO_SLASH);
// md5(主账户Id +主账户授权令牌 + 时间戳)
String sig = accountSid + authToken + timestamp;
// MD5加密
EncryptUtil eu = new EncryptUtil();
String signature = eu.md5Digest(sig);
 
String url = (new StringBuilder(hostname)).append(":").append(port)
.append("/").append(softVer).append("/Accounts/").append(accountSid)
.append("/SubAccounts?sig=").append(signature).toString();
// 创建HttpPost
HttpPost httppost = new HttpPost(url);
// 构造请求头信息
httppost.setHeader("Accept", "application/xml");
httppost.setHeader("Content-Type", "application/xml;charset=utf-8");
String src = accountSid + ":" + timestamp;
// base64(主账户Id + 冒号 +时间戳)
String auth = eu.base64Encoder(src);
httppost.setHeader("Authorization", auth);
 
// 构造Body
String body = (new StringBuilder("<?xml version='1.0' encoding='utf-8'?><SubAccount>")
.append("<appId>")).append(appId).append("</appId>")
.append("<friendlyName>").append(friendlyName).append("</friendlyName>")
.append("<accountSid>").append(accountSid).append("</accountSid>")
.append("<type>").append(type).append("</type>")
.append("<status>").append(status).append("</status></SubAccount>").toString();
 
BasicHttpEntity requestBody = new BasicHttpEntity();
requestBody.setContent(new ByteArrayInputStream(body.getBytes("UTF-8")));
requestBody.setContentLength(body.getBytes("UTF-8").length);
httppost.setEntity(requestBody);
 
// 执行客户端请求
HttpResponse response = httpclient.execute(httppost);
 
// 获取响应实体信息
HttpEntity entity = response.getEntity();
if (entity != null) {
result = EntityUtils.toString(entity, "UTF-8");
}
// 确保HTTP响应内容全部被读出或者内容流被关闭
EntityUtils.consume(entity);
} catch (Exception e) {
e.printStackTrace();
} finally{
// 关闭连接
httpclient.getConnectionManager().shutdown();
}
return result;
}

2 双向回拨

2.1 功能

客户侧发起请求，云通讯平台收到请求后，向两个落地电话终端发起呼叫请求，两终端接通电话后进行通话。

2.2 组包

构造请求URL内容：
• 获得系统时间戳；
• 拼接sig字符串，格式为“子账户ID + 子账户授权令牌 + 时间戳 ”，
• 使用MD5加密sig字符串，
• 拼接URL内容

构造请求头信息 ：
• 设置Accept项为“application/xml”；
• 设置Content-Type项为“application/xml;charset=utf-8”；
• 设置Authorization 项，先拼接字符串“子账户ID + 冒号 + 时间戳”，冒号为英文格式，再将字 符串进行Base64编码

构造Body ：
• 拼接XML格式字符串，字段包括子账户id、VoIP帐号、主叫号码、被叫号码

2.3 代码

/**
* @brief 双向回拨
* @param subAccountSid 子账号
* @param subToken 子账号令牌
* @param voipAccount VoIP账号
* @param from 主叫电话
* @param to 被叫电话
* @return Httppost 协议包封装
* @throws NoSuchAlgorithmException
* @throws KeyManagementException
*/
public String CallBack(String subAccountSid, String subToken, String voipAccount, String from, String to)
throws NoSuchAlgorithmException, KeyManagementException {
// 返回的响应字符串
String result = "";
// 创建HttpClient
CcopHttpClient chc = new CcopHttpClient();
DefaultHttpClient httpclient = chc.registerSSL("app.cloopen.com",
"TLS", 8883, "https");
try {
// 构造请求URL内容
String timestamp = DateUtil.dateToStr(new Date(),
DateUtil.DATE_TIME_NO_SLASH);// 时间戳
// md5(子账户Id + 子账户授权令牌 + 时间戳)
String sig = subAccountSid + subToken + timestamp;
// MD5加密
EncryptUtil eu = new EncryptUtil();
String signature = eu.md5Digest(sig);
 
String url = (new StringBuilder(hostname)).append(":").append(port)
.append("/").append(softVer)
.append("/SubAccounts/").append(subAccountSid)
.append("/Calls/Callback?sig=").append(signature).toString();
// 创建HttpPost
HttpPost httppost = new HttpPost(url);
// 构造请求头信息
httppost.setHeader("Accept", "application/xml");
httppost.setHeader("Content-Type", "application/xml;charset=utf-8");
String src = subAccountSid + ":" + timestamp;
String auth = eu.base64Encoder(src);
httppost.setHeader("Authorization", auth);// base64(子账户Id + 冒号 + 时间戳)
 
// 构造Body
String body = (new StringBuilder("<?xml version='1.0' encoding='utf-8'?><CallBack>")
.append("<subAccountSid>")).append(subAccountSid)
.append("</subAccountSid>").append("<voipAccount>").append(voipAccount)
.append("</voipAccount>").append("<from>").append(from)
.append("</from>").append("<to>").append(to)
.append("</to></CallBack>").toString();
 
BasicHttpEntity requestBody = new BasicHttpEntity();
requestBody.setContent(new ByteArrayInputStream(body.getBytes("UTF-8")));
requestBody.setContentLength(body.getBytes("UTF-8").length);
httppost.setEntity(requestBody);
 
// 执行客户端请求
HttpResponse response = httpclient.execute(httppost);
 
// 获取响应实体信息
HttpEntity entity = response.getEntity();
if (entity != null) {
result = EntityUtils.toString(entity, "UTF-8");
}
// 确保HTTP响应内容全部被读出或者内容流被关闭
EntityUtils.consume(entity);
} catch (Exception e) {
e.printStackTrace();
} finally{
// 关闭连接
httpclient.getConnectionManager().shutdown();
}
return result;
}

3 接口说明

1. 以上函数需要使用主账户或子账户鉴权，sig参数和包头中的时间戳必须一致。
2. 以上函数发送Https请求，得到结果为XML格式数据。
http://docs.cloopen.com/index.php/Java