平台 | 企业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 | 请求方法 | 是 | 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 | 备注 | 是 | 发送系统短信 | 用于申请时注明签名的使用场景及申请原因 |
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);
参数 | 示例 | 描述 |
---|---|---|
Code | 10005 | >0 短信申请提交成功,返回签名ID,此ID用于查询审核状态。 <=0 提交失败,具体原因请查询错误代码汇总表。 |
Message | 添加短信签名成功 | 代码中文提示 |
注意 | 1、每个ID最多允许10个签名申请。 2、取得签名ID后,需要保存好此ID用于查询审核状态。 3、需要等待审核成功后签名才能生效。 4、调用SignNameStatus取签名审核状态。 |
{ "Code":"10005", "Message":"添加短信签名成功" }