发送短信

 请求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 密钥 是 5c9ea69b74fbbd25f2cb6e3950f25a2f 将CorpID、Password(登录密码)、TimeStamp，这三个参数以字符串形式串接在一起，然后再使用MD5加密，MD5结果为32位字符串，不限大小写。密钥:MD5(CorpID+Password+TimeStamp) + 号不需要带入加密
TimeStamp String 时间戳，用于动态加密 是 20250220141645 格式为YYYYMMDDHHMMSS（年月日时分秒),注意：使用24小时制北京时间，并且保证此时间与标准时间相差不超过20分钟，否则服务器会拒绝请求。
Methods String 请求方法 是 SmsSend 不要放在内容（Content）后面作为参数传递
PhoneNumbers String 目标号码 是 18800000000 多个号码可以使用(英文,)号分隔，一条请求中号码不要超过50个，过多号码容易产生超时，从而造成不断重复发送。
Content String 短信内容 是 通知:您的验证码为：123456 发送的短信内容,不超过900个字    (内容含特殊字符，要先使用urlencode编码)
LongSms String 长短信 否 1 长短信有以下特点：
1、默认为长短信，该参数为0时不为长短信
2、分开多条发送的短信在手机屏幕上显示的是一整条。
3、每条拆分的短信最多支持67个字。
4、某些手机可能无法收到或无法显示长短信。
5、长短信只有一个签名，但非长短信，每条短信都需要带签名。
6、即使以长短信方式发送，当短信内容不足70字时，仍以普通短信发出。
TimerSend String 定时发送时间 否 2025-02-20 12:00:00 定时发送指的是先提交短信，当到达预置的定时时间才真正下发
AddNum String 扩展号码
(停用)		 否 运营商要求停用此参数，默认不能扩展 扩展号码，如果有，会在发送号码后添加上此号码
受不同运营商及不同地区影响，可扩展号码的长度是不定的，建议使用前进行不同长度的附加码测试

请求示例 postman


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

CorpID=305552&LoginName=admin&SecretKey=bd075468ee0c514840d157558e451815&TimeStamp=20250220141645&Methods=SmsSend&PhoneNumbers=18800000000&Content=验证码：123456&LongSms=1&TimerSend=2025-02-20 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=305552&LoginName=admin&SecretKey=bd075468ee0c514840d157558e451815&TimeStamp=20250220141645&Methods=SmsSend&PhoneNumbers=18800000000&Content=验证码：123456&LongSms=1&TimerSend=2025-02-20 12:00:00&AddNum=001");
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' => 'bd075468ee0c514840d157558e451815',
  'TimeStamp' => '20250220141645',
  'Methods' => 'SmsSend',
  'PhoneNumbers' => '18800000000',
  'Content' => '验证码：123456',
  'LongSms' => '1',
  'TimerSend' => '2025-02-20 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://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", "bd075468ee0c514840d157558e451815");
request.AddParameter("TimeStamp", "20250220141645");
request.AddParameter("Methods", "SmsSend");
request.AddParameter("PhoneNumbers", "18800000000");
request.AddParameter("Content", "验证码：123456");
request.AddParameter("LongSms", "1");
request.AddParameter("TimerSend", "2025-02-20 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"
    }]
}