申请短信签名

 请求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 密钥 c056606d7f45a8bc2b0abc478e658016 将CorpID、Password(登录密码)、TimeStamp,这三个参数以字符串形式串接在一起,然后再使用MD5加密,MD5结果为32位字符串,不限大小写。密钥:MD5(CorpID+Password+TimeStamp) + 号不需要带入加密
TimeStamp String 时间戳,用于动态加密 20250303155321 格式为YYYYMMDDHHMMSS(年月日时分秒),注意:使用24小时制北京时间,并且保证此时间与标准时间相差不超过20分钟,否则服务器会拒绝请求。
Methods String 请求方法 SignNameApply 申请短信签名
DefaultSignName String 是否默认签名 1 是否默认签名,这里填“1”
SignNameType String 签名归属 0 0-自有,1-他人
SignName String 签名 广州首易 3-12个字,建议8个字内  签名规则:执照全称是:广州首易信息技术有限公司,签名可以是  广州首易 或 首易信息 。签名不能跳字,像其他 首易公司 、 首易技术 或 首易ERP系统 等都不行。
Document1Type String 证明文件1类型 0 0-三证合一/营业执照,1-组织机构代码证,2-社会信用代码证,3-商标证书,4-网站备案证明,5-授权书,6-其它证明文件
Document1FileName String 证明文件1文件名称 图片.jpg 支持jpg,png,pdf 备注: 名称后需要带上文件扩展名 。
Document1FileData String 文件内容1 base64编码 base64 编码,小于2M
Document2Type String 证明文件2类型 1 0-三证合一/营业执照,1-组织机构代码证,2-社会信用代码证,3-商标证书,4-网站备案证明,5-授权书,6-其它证明文件
Document2FileName String 证明文件2文件名称 图片.jpg 支持jpg,png,pdf 备注: 名称后需要带上文件扩展名 。
Document2FileData String 文件内容2 base64 编码 base64 编码,小于2M
Document3Type String 证明文件3类型 2 0-三证合一/营业执照,1-组织机构代码证,2-社会信用代码证,3-商标证书,4-网站备案证明,5-授权书,6-其它证明文件
Document3FileName String 证明文件3文件名称 图片.jpg 支持jpg,png,pdf 备注: 名称后需要带上文件扩展名 。
Document3FileData String 文件内容3 base64 编码 base64 编码,小于2M
Remark 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=c056606d7f45a8bc2b0abc478e658016&TimeStamp=20250303155321&Methods=SignNameApply&DefaultSignName=1&SignNameType=0&SignName=广州首易&Document1Type=1&Document1FileName=type1.png&Document1FileData=base64字符串&Remark=测试申请签名


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=c056606d7f45a8bc2b0abc478e658016&TimeStamp=20250303155321&Methods=SignNameApply&DefaultSignName=1&SignNameType=0&SignName=广州首易&Document1Type=1&Document1FileName=type1.png&Document1FileData=base64字符串&Remark=测试申请签名");
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' => 'c056606d7f45a8bc2b0abc478e658016',
  'TimeStamp' => '20250303155321',
  'Methods' => 'SignNameApply',
  'DefaultSignName' => '1',
  'SignNameType' => '0',
  'SignName' => '广州首易',
  'Document1Type' => '1',
  'Document1FileName' => 'type1.png',
  'Document1FileData' => 'base64字符串',
  'Remark' => '测试申请签名'
));
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", "c056606d7f45a8bc2b0abc478e658016");
request.AddParameter("TimeStamp", "20250303155321");
request.AddParameter("Methods", "SignNameApply");
request.AddParameter("DefaultSignName", "1");
request.AddParameter("SignNameType", "0");
request.AddParameter("SignName", "广州首易");
request.AddParameter("Document1Type", "1");
request.AddParameter("Document1FileName", "type1.png");
request.AddParameter("Document1FileData", "base64字符串");
request.AddParameter("Remark", "测试申请签名");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

返回参数

 返回类型

  JSON
参数 示例 描述
Code 10005 >0 短信申请提交成功,返回签名ID,此ID用于查询审核状态。
<=0 提交失败,具体原因请查询错误代码汇总表。
Message 添加短信签名成功 代码中文提示
注意 1、每个ID最多允许10个签名申请。
2、取得签名ID后,需要保存好此ID用于查询审核状态。
3、需要等待审核成功后签名才能生效。
4、调用SignNameStatus取签名审核状态。

返回示例

{
    "Code":"10005",
    "Message":"添加短信签名成功"
}