短信api接口

短信发送接口：

• 请求方式：post
• 接口地址：https://market.juncdt.com/smartmarket/msgService/sendMessage
• 编码方式：utf-8
• 参数格式：json

请求参数说明：

名称	必填	类型	说明
accessKey	是	string	您可以在 我的接口-短信服务-获取密钥中找到：accessKey
accessSecret	是	string	您可以在 我的接口-短信服务-获取密钥中找到：accessSecret
classificationSecret	是	string	您可以在 短信服务-获取密钥中找到：套餐码
signCode	是	string	短信签名code(您可以在 我的接口-短信设置-签名管理-签名CODE列找到)
templateCode	是	string	短信模板code(您可以在 我的接口-短信设置-模板管理-模板CODE列找到)
phone	是	string	目标手机号
params	否	map	若有参数则必填且参数需与所选模版中参数名称以及数量一致

JSON请求示例：

• {
• "accessKey":"您可以在 我的接口-短信服务-获取密钥中找到：accessKey",
• "accessSecret":"您可以在 我的接口-短信服务-获取密钥中找到：accessSecret",
• "classificationSecret":"您可以在 短信服务-获取密钥中找到：套餐码",
• "signCode":"设置短信签名的CODE(您可以在 我的接口-短信设置-签名管理-签名CODE列找到)",
• "templateCode":"设置短信模板的CODE(您可以在 我的接口-短信设置-模板管理-模板CODE列找到)",
• "phone":"11位的手机号",
• "params":{
• "code":"例如：短信模板为 - 您的验证码为${code}，此时参数名称为code,value按业务方需求填写"
• }
• }

公共响应参数说明：

名称	类型	说明
BusinessData	object	业务数据
BusinessException	object	异常数据
Timestamps	long	时间戳

BusinessData参数说明：

名称	类型	说明
code	int	结果返回码
msg	string	结果消息描述
phone	string	目标手机号

JSON响应示例：

• {
• "BusinessData":{
• "code":10000,
• "msg":"短信发送成功",
• "phone":"13800138000",
• },
• "Timestamps":1627540760769,
• "BusinessException":{
• "resultCode":1000,
• "resultMessage":"操作成功"
• }
• }

示例代码——Java：

• import com.alibaba.fastjson.JSONObject;
• import cn.hutool.http.HttpUtil;{
• import java.util.HashMap;
• import java.util.Map;
• /**
• * 云极发送短信示例
• * 说明：需要引入两个jar包，fastjson和hutool工具包
• * pom文件加入配置如下：
• * <dependency>
• * <groupId>com.alibaba</groupId>
• * <artifactId>fastjson</artifactId>
• * <version>1.2.69</version>
• * </dependency>
• * <dependency>
• * <groupId>cn.hutool</groupId>
• * <artifactId>hutool-all</artifactId>
• * <version>5.4.3</version>
• * </dependency>
• * @author junbs
• * @since 2021/10/21 21:22 下午
• */
• public class SmsSendDemo {
• public static void main(String[] args) {
• String url = "https://market.juncdt.com/smartmarket/msgService/sendMessage";
• JSONObject jsonBody = new JSONObject();
• jsonBody.put("accessKey", "这里填accessKey");
• jsonBody.put("accessSecret", "这里填accessSecret");
• jsonBody.put("classificationSecret", "这里填短信套餐分类码");
• jsonBody.put("signCode", "这里填短信签名code");
• jsonBody.put("templateCode", "这里填短信模版code");
• jsonBody.put("phone", "这里填目标手机号码");
• // 变量参数用map存
• Map<String, String> params = new HashMap<>();
• // 验证码参数示例
• params.put("code", "这里填验证码");
• // 自定义变量参数示例
• //params.put("这里填自定义变量名", "这里填自定义变量值");
• //params.put("money", "100");
• //params.put("name", "测试");
• //params.put("typeName", "微信");
• // 变量参数map存入json对象
• jsonBody.put("params", params);
• System.out.println(jsonBody);
• System.out.println(doPost(url, jsonBody));
• }
• /**
• * 发起post请求
• * @param url 请求url
• * @param json json格式请求体
• * @return json格式响应体
• */
• public static JSONObject doPost(String url, JSONObject json) {
• JSONObject response;
• try {
• String result = HttpUtil.post(url, json.toString());// 返回json格式
• response = JSONObject.parseObject(result);
• } catch (Exception e) {
• throw new RuntimeException(e);
• }
• return response;
• }
• }

示例代码——PHP：

• public function phpSendMessage(){
• //接入账号，从云极个人中心获取
• $accessKey = "这里填accessKey";
• //接入密钥，从云极个人中心获取
• $accessSecret = "这里填accessSecret";
• //套餐码，从云极个人中心获取
• $classificationSecret = '这里填accessSecret';
• //短信签名code，从云极个人中心获取
• $signCode = '这里填短信签名code';
• //短信模板code，从云极个人中心获取
• $templateCode = '这里填短信模版code';
• //手机号，仅支持单个
• $phone = '这里填目标手机号码';
• //如模板有变量，根据自己真实变量名称、个数填写，变量名和变量值一一对应，格式如下;如果模板无变量则为空
• $params = [
• "code" => "1234",
• ];
• ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
• $data = [
• "accessKey" => $accessKey,
• "accessSecret" => $accessSecret,
• "classificationSecret" => $classificationSecret,
• "signCode" => $signCode,
• "templateCode" => $templateCode,
• "phone" => $phone,
• "params" => $params
• ];
• if(empty($params)){
• unset($data['params']);
• }
• //curl请求
• $ch = curl_init("https://market.juncdt.com/smartmarket/msgService/sendMessage"); //请求的URL地址
• curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
• curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));//$data JSON类型字符串
• curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
• curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'Content-Length: ' . strlen(json_encode($data))));
• curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
• curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
• $output = curl_exec($ch);
• if($output === false)
• {
• //请求失败，打印失败原因
• echo 'Curl error: ' . curl_error($ch);
• }
• curl_close($ch);
• print_r($output."\n");
• }

错误代码参照：

错误码	说明
10000	短信发送成功
10001	短信发送失败
30001	签名未经审核，无法使用
30002	签名已被冻结，无法使用
30003	模板未经审核，无法使用
30004	模板已被冻结，无法使用
30005	无效的签名CODE
30006	无效的模板CODE
30007	发送失败,签名中含有非法关键词!
30008	发送失败,模板中含有非法关键词!
30009	系统异常，请联系技术人员!
30010	手机号码不能为空，至少需要一个手机号码!
30011	手机号码校验失败，非法手机号码!
30012	手短信内容不能为空!
30013	发送失败,短信内容中含有非法关键词!
30014	变量不匹配，存在非法变量,请重新检查变量名称，变量属性，详情请参考变量说明
30015	发送失败，用户无权使用该签名！
30016	发送失败，用户无权使用该模板！
30017	内容超过最大长度300!
30018	不支持发送的手机号段，请检查是否为移动。联通。电信三大运营商的手机号段!
30019	当前功能接口可用次数不足，请重新购买后再次重试!
30020	验签失败，请重新检查参数!
30021	签名信息缺失,请重新检查!
30022	accessKey信息缺失,请重新检查!
30023	非法或者无效的调用!
30024	无效accessKey,请重新检查!
30025	无效套餐码,请重新检查!
30026	使用模板类型与套餐码不匹配，请求失败!
30027	一次请求发送目标手机号码最多500个!
30028	请求发送的目标手机号已经超过当日发送上限