发送短信

请求参数

参数 类型 描述 是否必须 示例 提示
Methods String 请求方法 是 SmsSend 不要放在内容（Content）后面作为参数传递
PhoneNumbers String 目标号码 是 18800000000 多个号码可以使用(英文,)号分隔，一条请求中号码不要超过50个，过多号码容易产生超时，从而造成不断重复发送。
Content String 短信内容 是 通知:您的验证码为：123456 要发送的短信内容,不超过900个字
LongSms String 长短信 否 1 长短信有以下特点：
1、默认为长短信，该参数为0时不为长短信
2、分开多条发送的短信在手机屏幕上显示的是一整条。
3、每条拆分的短信最多支持67个字。
4、某些手机可能无法收到或无法显示长短信。
5、长短信只有一个签名，但非长短信，每条短信都需要带签名。
6、即使以长短信方式发送，当短信内容不足70字时，仍以普通短信发出。
TimerSend String 定时发送时间 否 2023-10-01 12:00:00 定时发送指的是先提交短信，当到达预置的定时时间才真正下发
AddNum String 扩展号码
(停用)		 否 运营商要求停用此参数，默认不能扩展 扩展号码，如果有，会在发送号码后添加上此号码
受不同运营商及不同地区影响，可扩展号码的长度是不定的，建议使用前进行不同长度的附加码测试

请求示例


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

CorpID=100000&LoginName=Admin&SecretKey=bd075468ee0c514840d157558e451815&TimeStamp=20230919104350&Methods=SmsSend&PhoneNumbers=18800000000&Content=验证码：123456&LongSms=1&TimerSend=2023-10-01 12:00:00&AddNum=001



OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "CorpID=100000&LoginName=Admin&SecretKey=bd075468ee0c514840d157558e451815&TimeStamp=20230919104350&Methods=SmsSend&PhoneNumbers=18800000000&Content=验证码：123456&LongSms=1&TimerSend=2023-10-01 12:00:00&AddNum=001");
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' => 'Admin',
  'SecretKey' => 'bd075468ee0c514840d157558e451815',
  'TimeStamp' => '20230919104350',
  'Methods' => 'SmsSend',
  'PhoneNumbers' => '18800000000',
  'Content' => '验证码：123456',
  'LongSms' => '1',
  'TimerSend' => '2023-10-01 12:00:00',
  'AddNum' => '001'
));
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", "Admin");
request.AddParameter("SecretKey", "bd075468ee0c514840d157558e451815");
request.AddParameter("TimeStamp", "20230919104350");
request.AddParameter("Methods", "SmsSend");
request.AddParameter("PhoneNumbers", "18800000000");
request.AddParameter("Content", "验证码：123456");
request.AddParameter("LongSms", "1");
request.AddParameter("TimerSend", "2023-10-01 12:00:00");
request.AddParameter("AddNum", "001");
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"
    }]
}