短信服务

Service Project

AG捕鱼

短信营销平台

AG捕鱼·产品简介


短信群发不受地域限制,国内皆可几秒便发送到用户手机上......

AG捕鱼·产品详情

短信营销平台优势:

短信营销平台
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 请求发送的目标手机号已经超过当日发送上限
AG捕鱼·产品背景图
 
电话: 15979290517
 
邮箱: gongsy@juncdt.com
 
地址: 中国杭州 云栖小镇 鲤鱼山街18号3幢4层
 
  • 专业

    短信群发专业服务商

  • 保障

    电信级运维保障,实时监控自动切换

  • 用心

    提供优质的售后服务

  • 便捷

    快速触达,连接用户只需要3秒

全国分站:榆树 玉溪 营口 齐齐哈尔 长治 霍邱 齐齐哈尔 宜春