CreateSmsSign_短信服务_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 新接口和原接口变更的公告详情请参见关于短信服务更新签名&模板接口的公告

  • 个人认证用户,同一个阿里云账号一个自然日支持申请一个正式签名;企业认证用户目前无限制。个人用户与企业用户权益区别详情请参见使用须知

  • 请阅读签名规范,了解短信签名审核规范的具体内容。

  • 通过接口申请的签名信息会同步在短信服务控制台。控制台相关操作,请参见短信签名

  • 提交签名申请后,您可以通过 GetSmsSign 接口查询签名审核状态和详情。也可以配置回执消息,通过 SignSmsReport 获取签名的审核状态消息。

流控信息

请求速率为500/1(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
dysms:CreateSmsSign
None
全部资源
*

请求参数

字段名称字段详情
SignNamestring

签名名称,签名名称请遵守签名规范展开详情

示例值:阿里云验证码参考取值来源:
    UpdateSmsSign
    AddSmsSign
    QuerySmsSignList
    ModifySmsSign
Remarkstring

短信签名场景说明,是签名审核的参考信息之一,长度不超过 200 个字符。展开详情

示例值:登录场景使用验证码字符长度 <= 500
SignTypeinteger<int32>

签名类型。取值:展开详情

示例值:1
MoreDataarray<string>

更多资料。补充上传业务证明文件或业务截图,有助于审核人员了解您的业务详情。请参见签名申请材料,上传相关材料。

QualificationIdinteger<int64>

已审核通过的资质 ID。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:8563**
ApplySceneContentstring

App 应用商店链接。若签名来源为“已上线 App”,即SignSource取值为 2 时,请填写 http://或 https://开头的应用商店链接,并确保 App 已经上线。

示例值:http://www.aliyun.com/
SignSourceinteger<int32>

签名来源。取值:展开详情

示例值:0枚举值:025
ThirdPartyboolean

签名用途。取值:展开详情

示例值:false
AuthorizationLetterIdinteger<int64>

委托授权书 ID,当签名为他用时,委托授权书 ID 不可为空,否则签名审核不通过。委托授权书的社会统一信用代码必须与签名绑定的资质信息中社会统一信用代码字段保持一致,否则创建签名失败。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1000********1234参考取值来源:
    QuerySmsAuthorizationLetter

返回参数

字段名称字段详情
RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

示例值:CCA2BCFF-2BA7-427C-90EE-AC6994748607
Codestring

请求状态码。取值:展开详情

示例值:OK
Messagestring

状态码的描述。

示例值:successful
SignNamestring

签名名称。

示例值:阿里云验证码
OrderIdstring

工单号。展开详情

示例值:2004415****

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
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.诊断
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.诊断

变更历史

变更时间变更内容概要操作
2025-04-17
变更请求参数AuthorizationLetterId
2025-04-16
变更错误码400
新增请求参数AuthorizationLetterId

相关示例