平台 | 企业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 |
参数 | 类型 | 描述 | 是否必须 | 示例 | 提示 |
---|---|---|---|---|---|
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 | 请求方法 | 是 | TemplateAdd | 添加短信模板 |
TemplateType | String | 模板类型 | 是 | 1 | 1-应用模板,2-营销模板 |
TemplateName | String | 模板名称 | 是 | 首易应用模板 | 用户定义,便于记忆与区分 |
TemplateContent | String | 模板内容 | 是 | 你注册{1}应用的验证码为{2},有效时间{3}分钟。验证码请不要告诉其它人! | 模板内容,由固定内容与可变内容组成,最长为500个字。 固定内容为短信主体,发送时不变。 可变内容使用{N}表示(N为数字,1-5),发送时将替换为相应参数。 |
Remark | String | 备注 | 是 | 通知使用 | 用于申请时注明模板的使用场景及申请原因 |
IsTemporary | String | 是否临时模板 | 是 | 0 | 0-永久模板,1-临时模板。如为临时模板,7天后系统会自动删除。 |
POST /SDK3/Sms HTTP/1.1
Host: sms3.mobset.com:8095
Content-Type: application/x-www-form-urlencoded
CorpID=305552&LoginName=admin&SecretKey=edaee70068e20df88ce64b707c2983a7&TimeStamp=20250303155321&Methods=TemplateAdd&TemplateType=1&TemplateName=易应用模板&TemplateContent=你注册{1}应用的验证码为{2},有效时间{3}分钟。验证码请不要告诉其它人!&Remark=测试首易应用模板&IsTemporary=1
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=edaee70068e20df88ce64b707c2983a7&TimeStamp=20250303155321&Methods=TemplateAdd&TemplateType=1&TemplateName=首易应用模板&TemplateContent=你注册{1}应用的验证码为{2},有效时间{3}分钟。验证码请不要告诉其它人!&Remark=测试首易应用模板&IsTemporary=1");
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' => 'edaee70068e20df88ce64b707c2983a7',
'TimeStamp' => '20250303155321',
'Methods' => 'TemplateAdd',
'TemplateType' => '1',
'TemplateName' => '首易应用模板',
'TemplateContent' => '你注册{1}应用的验证码为{2},有效时间{3}分钟。验证码请不要告诉其它人!',
'Remark' => '测试首易应用模板',
'IsTemporary' => '1'
));
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", "edaee70068e20df88ce64b707c2983a7");
request.AddParameter("TimeStamp", "20250303155321");
request.AddParameter("Methods", "TemplateAdd");
request.AddParameter("TemplateType", "1");
request.AddParameter("TemplateName", "首易应用模板");
request.AddParameter("TemplateContent", "你注册{1}应用的验证码为{2},有效时间{3}分钟。验证码请不要告诉其它人!");
request.AddParameter("Remark", "测试首易应用模板");
request.AddParameter("IsTemporary", "1");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
参数 | 示例 | 描述 |
---|---|---|
Code | 10110 | >0 提交模板成功。返回模板ID。 <0 提交失败,具体原因请查询错误代码汇总表。 |
Message | 添加短信模板成功 | 代码中文提示 |
注意 | 1、每个ID最多允许建立100个短信模板。 2、取得短信模板ID后,需要保存好此ID。 3、添加短信模板后,需要等待审核成功后才能使用。 4、调用Template_Query取短信模板审核状态。 |
{ "Code":"10110", "Message":"添加短信模板成功" }