参数 | 类型 | 描述 | 是否必须 | 示例 | 提示 |
---|---|---|---|---|---|
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);
参数 | 示例 | 描述 |
---|---|---|
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" }] }