发送模板短信

请求URL

平台	企业ID范围	协议	请求地址
平台1	企业ID100000~199999	GET,POST	http://sms.mobset.com:8095/SDK3/Sms <推荐> https://sms.mobset.com:843/SDK3/SMS
平台2	企业ID200000~299999	GET,POST	http://sms2.mobset.com:8095/SDK3/Sms <推荐> https://sms2.mobset.com:843/SDK3/SMS
平台3	企业ID300000~399999	GET,POST	http://sms3.mobset.com:8095/SDK3/Sms <推荐> https://sms3.mobset.com:843/SDK3/SMS

编码模式

UTF-8

Content-Type

application/x-www-form-urlencoded

请求参数

参数	类型	描述	是否必须	示例	提示
CorpID	String	企业ID	是	305552	在短信易平台开户时为每个企业分配的唯一代码,注意企业ID与域名对应
LoginName	String	登录名	是	admin	不能使用中文作为登录名
SecretKey	String	密钥	是	c056606d7f45a8bc2b0abc478e658016	将CorpID、Password(登录密码)、TimeStamp，这三个参数以字符串形式串接在一起，然后再使用MD5加密，MD5结果为32位字符串，不限大小写。密钥:MD5(CorpID+Password+TimeStamp) + 号不需要带入加密
TimeStamp	String	时间戳，用于动态加密	是	20250303155321	格式为YYYYMMDDHHMMSS（年月日时分秒),注意：使用24小时制北京时间，并且保证此时间与标准时间相差不超过20分钟，否则服务器会拒绝请求。
Methods	String	请求方法	是	TemplateSendSms	发送模板短信
AddNum	String	扩展号码	否		受不同运营商及不同地区影响，可扩展号码的长度是不定的，建议使用前进行不同长度的附加码测试
Timer	String	定时发送时间	否	2025-03-03 12:00:00	定时发送指的是先提交短信，当到达预置的定时时间才真正下发
Mobiles	String	发送目标号码	是	1880000000	发送目标号码，多个号码可以使用英文,号分隔注意一条请求中号码不要超过50个，过多号码容易产生超时，从而造成不断重复发送。
TemplateID	String	模板ID	是	20249	添加短信模板返回的模板ID
param1	String	参数值	否	广州首易	参数值，每个参数内容最长为30个字（可能会根据政策动态调整）
param1	String	参数值	否	12345666	参数值，每个参数内容最长为30个字（可能会根据政策动态调整）
param1	String	参数值	否	5	参数值，每个参数内容最长为30个字（可能会根据政策动态调整）

请求示例 postman


POST /SDK3/Sms HTTP/1.1
Host: sms3.mobset.com:8095
Content-Type: application/x-www-form-urlencoded

CorpID=305552&LoginName=admin&SecretKey=c056606d7f45a8bc2b0abc478e658016&TimeStamp=20250303155321&Methods=TemplateSendSms&AddNum=1&Timer=&Mobiles=1880000000&TemplateID=20249&Param1=广州首易&Param2=12345666&Param3=5


OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "CorpID=305552&LoginName=admin&SecretKey=c056606d7f45a8bc2b0abc478e658016&TimeStamp=20250303155321&Methods=TemplateSendSms&AddNum=1&Timer=&Mobiles=1880000000&TemplateID=20249&Param1=广州首易&Param2=12345666&Param3=5");
Request request = new Request.Builder()
  .url("http://sms3.mobset.com:8095/SDK3/Sms")
  .method("POST", body)
  .addHeader("Content-Type", "application/x-www-form-urlencoded")
  .build();
Response response = client.newCall(request).execute();


setUrl('http://sms3.mobset.com:8095/SDK3/Sms');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Content-Type' => 'application/x-www-form-urlencoded'
));
$request->addPostParameter(array(
  'CorpID' => '305552',
  'LoginName' => 'admin',
  'SecretKey' => 'c056606d7f45a8bc2b0abc478e658016',
  'TimeStamp' => '20250303155321',
  'Methods' => 'TemplateSendSms',
  'AddNum' => '1',
  'Timer' => '',
  'Mobiles' => '1880000000',
  'TemplateID' => '20249',
  'param1' => '广州首易',
  'param2' => '12345666',
  'param3' => '5'
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}


var client = new RestClient("http://sms3.mobset.com:8095/SDK3/Sms");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
request.AddParameter("CorpID", "305552");
request.AddParameter("LoginName", "admin");
request.AddParameter("SecretKey", "c056606d7f45a8bc2b0abc478e658016");
request.AddParameter("TimeStamp", "20250303155321");
request.AddParameter("Methods", "TemplateSendSms");
request.AddParameter("AddNum", "1");
request.AddParameter("Timer", "");
request.AddParameter("Mobiles", "18800000000");
request.AddParameter("TemplateID", "20249");
request.AddParameter("param1", "广州首易");
request.AddParameter("param2", "12345666");
request.AddParameter("param3", "5");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

返回参数

返回类型

JSON

参数	示例	描述
Code	1	>0 发送成功。由于网络原因，返回的时间可能会较长，在调用时，建议控制超时值应大于30秒。 <0 提交失败，具体原因请查询错误代码汇总表。 Code返回数为长短信拆分后的条数，例如一条长短信有120字则返回值为2，同一个请求有两个号码内容都为120字的长短信，则返回为4
Message	成功提交1条短信	代码中文提示
SmsIdList	短信ID集合	"SmsIdList": [{ "PhoneNumber": "18800000000", "SmsId": "1355555551" }] 如提交失败，则不返回该集合；错误返回示例：{ "Code" : -110,"Message" : "短信内容长度不符合要求"}
PhoneNumber	18800000000	提交的手机号
SmsId	短信ID，短信的唯一标识	1355555551

返回示例

{
    "Code": "1",
    "Message": "成功提交1条短信",
    "SmsIdList": [{
        "PhoneNumber": "18800000000",
        "SmsId": "1355555551"
    }]
}