发送模板短信

请求参数

参数 类型 描述 是否必须 示例 提示
Methods String 请求方法 TemplateSendSms 发送模板短信
Timer String 定时发送时间 2023-10-01 12:00:00 定时发送指的是先提交短信,当到达预置的定时时间才真正下发
Mobiles String 发送目标号码 1880000000 发送目标号码,多个号码可以使用英文,号分隔
注意一条请求中号码不要超过50个,过多号码容易产生超时,从而造成不断重复发送。
TemplateID String 模板ID 10110 添加短信模板返回的模板ID
param1 String 参数值 参数1 参数值,每个参数内容最长为30个字(可能会根据政策动态调整)
param...9 String 参数值 参数9 备注最多入参9个参数(param1-param9)

请求示例


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

CorpID=100000&LoginName=fuyj&SecretKey=0bd2ae8603e226ad66b6193582e2c7b4&TimeStamp=20230921160000&Methods=TemplateSendSms&AddNum=1&Timer=&Mobiles=1880000000&TemplateID=10110&Param1=广州首易&Param2=123456&Param3=3


OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "CorpID=100000&LoginName=fuyj&SecretKey=0bd2ae8603e226ad66b6193582e2c7b4&TimeStamp=20230921160000&Methods=TemplateSendSms&AddNum=1&Timer=&Mobiles=1880000000&TemplateID=10110&Param1=广州首易&Param2=123456&Param3=3");
Request request = new Request.Builder()
  .url("http://sms.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://sms.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' => '100000',
  'LoginName' => 'fuyj',
  'SecretKey' => '0bd2ae8603e226ad66b6193582e2c7b4',
  'TimeStamp' => '20230921160000',
  'Methods' => 'TemplateSendSms',
  'AddNum' => '1',
  'Timer' => '',
  'Mobiles' => '1880000000',
  'TemplateID' => '10110',
  'param1' => '广州首易',
  'param2' => '123456',
  'param3' => '3'
));
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://sms.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", "100000");
request.AddParameter("LoginName", "fuyj");
request.AddParameter("SecretKey", "0bd2ae8603e226ad66b6193582e2c7b4");
request.AddParameter("TimeStamp", "20230921160000");
request.AddParameter("Methods", "TemplateSendSms");
request.AddParameter("AddNum", "1");
request.AddParameter("Timer", "");
request.AddParameter("Mobiles", "18800000000");
request.AddParameter("TemplateID", "10110");
request.AddParameter("param1", "广州首易");
request.AddParameter("param2", "123456");
request.AddParameter("param3", "3");
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"
    }]
}