CreateSmsSign - 申请短信签名（新接口）_短信服务(SMS)-阿里云帮助中心

短信签名作为短信发送方的一种标识，发送短信前，您需要先申请签名和模板，系统会将已审核通过的短信签名添加到短信内容的开头，并与短信内容一起发送给接收方。

接口说明

新接口和原接口变更的公告详情请参见关于短信服务更新签名&模板接口的公告。
个人认证用户，同一个阿里云账号一个自然日支持申请一个正式签名；企业认证用户目前无限制。个人用户与企业用户权益区别详情请参见使用须知。
请阅读签名规范，了解短信签名审核规范的具体内容。
通过接口申请的签名信息会同步在短信服务控制台。控制台相关操作，请参见短信签名。
提交签名申请后，您可以通过 GetSmsSign 接口查询签名审核状态和详情。也可以配置回执消息，通过 SignSmsReport 获取签名的审核状态消息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dysms:CreateSmsSign

none

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
SignName	string	是	签名名称，签名名称请遵守签名规范：长度限 2~12 字符，不支持包含“测试”、“test”等字样。不支持添加【】、()、[]等符号；不支持、，。空格等特殊字符。说明签名名称区分大小写字母，如【Aliyun 通信】和【aliyun 通信】视为两个不同的签名。当您的验证码签名和通用签名名称相同时，系统默认使用通用签名发送短信。	阿里云验证码
Remark	string	否	短信签名场景说明，是签名审核的参考信息之一，长度不超过 200 个字符。说明您可以提供已上线业务的使用场景，并提供实际业务的网站链接、应用市场下载链接等。您可以提供短信完整示例，体现您的业务场景。您可以提供变量的传参内容，详细描述业务使用场景和选择这个变量属性的原因。若签名涉及政企机关单位，请备注政企机关单位的固定电话。信息完善的申请说明会提高签名、模板的审核效率。如未按规范进行填写或不填写，可能会影响您签名审核的通过。	登录场景使用验证码
SignType	integer	否	签名类型。取值： 0：验证码。 1：通用（默认值）。建议使用默认值：通用。	1
MoreData	array	否	更多资料。补充上传业务证明文件或业务截图，有助于审核人员了解您的业务详情。请参见签名申请材料，上传相关材料。
	string	否	上传到 OSS 的文件信息。文件上传操作，请参见 OSS 上传文件。	10098689758*****/123qwe.png
QualificationId	integer	是	已审核通过的资质 ID。说明在申请短信签名前，请先申请资质。您可在资质管理页面查看资质 ID。	8563**
ApplySceneContent	string	否	App 应用商店链接。若签名来源为“已上线 App”，即`SignSource`取值为 2 时，请填写 http://或 https://开头的应用商店链接，并确保 App 已经上线。	http://www.aliyun.com/
SignSource	integer	是	签名来源。取值： 0：企事业单位的全称或简称。 2：App 应用的全称或简称。 5：商标名的全称或简称。签名来源的详细说明请参见签名来源。	0
ThirdParty	boolean	否	签名用途。取值： false：自用（默认值，签名为本账号实名认证的企业、网站、产品名等）。 true：他用（签名为非本账号实名认证的企业、网站、产品名等）。重要签名为自用时，请选择自用资质 ID；签名为他用时，请选择他用资质 ID。	false
AuthorizationLetterId	integer	否	委托授权书 ID，当签名为他用时，委托授权书 ID 不可为空，否则签名审核不通过。委托授权书的社会统一信用代码必须与签名绑定的资质信息中社会统一信用代码字段保持一致，否则创建签名失败。	1000********1234

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	CCA2BCFF-2BA7-427C-90EE-AC6994748623
Code	string	请求状态码。取值： OK：代表请求成功。其他错误码，请参见错误码列表。	OK
Message	string	状态码的描述。	successful
SignName	string	签名名称。	阿里云
OrderId	string	工单号。审核人员查询审核时会用到此参数。您需要审核加急时需要提供此工单号。	2004415****

示例

正常返回示例

JSON格式

{
  "RequestId": "CCA2BCFF-2BA7-427C-90EE-AC6994748623",
  "Code": "OK",
  "Message": "successful",
  "SignName": "阿里云",
  "OrderId": "2004415****"
}

错误码

HTTP status code	错误码	错误信息	描述
400	ForbiddenAction	Access to the account is denied. Please contact the administrator.
400	ParameterMismatch.ThirdParty	The type of signature, whether for personal use or for a third party, should be consistent with the qualifications.	签名是否第三方使用应和资质保持一致。
400	SignName.Exists	Sorry, this signature already exists and cannot be applied for again.	抱歉，此签名已经存在，不可重复申请。
400	InvalidQualification	The qualification should be approved.	无效的资质，资质应审核通过。
400	InvalidSignName	The signature cannot contain spaces, special symbols, or all numbers.	签名不能包含简体中文、英文、数字之外的空格等特殊字符，且不能为全数字。
400	InvalidApplySceneContent	For certain signature sources, the applySceneContent should be an HTTP or HTTPS link.	无效的应用场景，在某些签名来源下，应用场景应是HTTP或者HTTPS的链接。
400	MissApplySceneContent	In some signature sources, the applySceneContent is required.	在某些签名来源下，应用场景必填
400	MissingSignName	The signature name cannot be empty.	签名名称不能为空
400	SmsAuthorizationLetterNotMatch	Please bind the available authorization letter whose the social credit code is same to the the social credit code of qualification.	请绑定和资质统一社会信用代码一致的且可用的资质授权书
400	SmsAuthorizationLetterNotExist	Authorization does not belong to the customer.	授权书不属于该客户
400	SmsSignNotAuthorized	the signature is not in the sign scope of the authorization letter.	该签名不在授权书范围内容
404	QualificationNotFound	Qualification does not exist.	资质不存在。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。