GetSmsSign - 查询签名详情（新接口）_短信服务(SMS)-阿里云帮助中心

申请签名后，通过此接口查询签名审核详情。

接口说明

仅可查询首次创建的签名资料或者最新审核通过的资料。
新接口和原接口变更的公告详情请参见关于短信服务更新签名&模板接口的公告。
审核时间：一般情况下，签名提交后，阿里云预计在 2 个小时内审核完成（审核工作时间：周一至周日 9:00~21:00，法定节假日顺延）。
如果签名未通过审核，会返回审核失败的原因，请参考短信审核失败的处理建议，调用 UpdateSmsSign 接口或在签名管理页面修改未审核通过的短信签名。
QuerySmsSignList 接口可以查询您账号下的所有签名，包括签名审核状态、签名类型、签名名称等。
本接口的单用户 QPS 限制为 150 次/秒。超过限制，API 调用将会被限流，这可能会影响您的业务，请合理调用。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

dysms:GetSmsSign

none

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
SignName	string	是	签名名称。必须是本账号已申请的短信签名。调用 CreateSmsSign 接口后在返回参数中获取。在签名管理页面查看签名。	阿里云

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	F655A8D5-B967-440B-8683-DAD6FF8DE990
Code	string	请求状态码。取值： OK：代表请求成功。其他错误码，请参见 API 错误码。	OK
Message	string	状态码的描述。	OK
SignName	string	短信签名名称。	登录验证
SignStatus	integer	签名审核状态。取值： 0：审核中。 1：审核通过。 2：审核失败，请在返回参数`AuditInfo.RejectInfo`中查看审核失败原因。 10：取消审核。	2
CreateDate	string	短信签名的创建日期和时间。	2024-06-03 10:02:34
OrderId	string	工单号。审核人员查询审核时会用到此参数。您需要审核加急时需要提供此工单号。	20044156924
QualificationId	integer	资质 ID。申请签名时关联的资质 ID。	2004393****
Remark	string	短信签名场景说明，长度不超过 200 个字符。	登录场景验证码
AuditInfo	object	审核信息。
RejectInfo	string	审批未通过的原因。	通过资质信息，不能判断是否可以申请此签名。
AuditDate	string	审核时间。	2024-06-03 12:02:34
FileUrlList	array	更多资料信息，补充上传业务证明文件或业务截图文件列表。
	string	上传到 OSS 上的文件信息。	10098689758*****/1234qwe.png
SignCode	string	短信签名 Code。	SIGN_100000077042023_17174665*****_ZM2kG
SignTag	string	签名标识。取值： 2：用户自定义创建签名。 3：系统赠送签名。 4：测试签名。 5：试用签名。	2
ApplyScene	string	应用场景内容。	http://www.aliyun.com/
ThirdParty	boolean	签名为自用或他用。 false：自用（默认值）。 true：他用。	false
SignUsage	string	签名使用场景。	已注册商标名称。
RegisterResult	integer	已废弃，请使用`SignIspRegisterDetailList`查看各运营商实名报备结果。签名实名制报备结果。取值： 0：报备失败。 1：报备成功。 2：报备失效。 -1：无状态。建议您单击查看更多签名实名制报备内容及建议操作。	1
AuthorizationLetterId	integer	委托授权书 ID。	1000********1234
AuthorizationLetterAuditPass	boolean	委托授权书审核状态。取值： true：审核通过。 false：审核未通过（包含审核通过外的其他所有状态）。	true
SignIspRegisterDetailList	array<object>	运营商报备状态列表。获取此参数返回数据需要更新 SDK至 4.1.2 版本或以上。
	object
RegisterStatus	integer	报备状态。取值： 0：报备失败，原因可能为资质信息与工信注册信息不一致或运营商侧无法支持等。建议您登录短信服务控制台查看具体失败原因，并依据提示进行操作； 1：已报备待验证，当前至少有一个子端口号运营商已返回报备通过，建议您少量多次向不同运营商手机号发送验证码、通知短信进行验证； 2：报备失效，签名超过 6 个月无发送记录时，报备结果失效。如您需要重新启用该签名，请在短信服务控制台重新发起报备； 3：报备成功，当前至少有一个子端口号运营商已返回报备通过，经验证短信发送成功率符合预期，建议您持续关注发送成功率； -1：报备中，当前尚未收到运营商反馈的报备结果，建议您等待签名报备状态变更为“已报备待验证”后再批量发送，当前可少量多次尝试使用该签名发送，观察短信发送效果； -2：未报备，原因可能为当前签名未关联实名资质或关联资质信息不全，建议您修改当前资质或编辑签名绑定其他资质以重新发起报备。建议您单击查看更多签名实名制报备内容及建议操作。	0
OperatorCode	string	运营商类型。取值： mobile：中国移动； unicom：中国联通； telecom：中国电信。	telecom
OperatorCompleteTime	string	运营商反馈时间，格式为 yyyy-MM-dd HH:mm:ss。	2025-06-13 15:55:26
RegisterStatusReasons	array<object>	报备状态原因列表。
	object
ReasonCode	string	报备状态原因码。取值： UNBINDING_QUA：签名未关联资质； BINDING_INCOMPLETE_QUA：关联资质信息不全； NON_REGISTER：未发起报备； REGISTERING：签名报备中； DETECTING：未发起探测或探测中； DETECT_SUCCESS：报备成功； QUALIFICATION_ERROR：资质原因； SIGNATURE_ERROR：签名原因； SIGNATURE_QUALIFICATION_ERROR：签名与资质关系不符； ONE_CODE_MULTIPLE_SIGN：扩展码原因； OTHERS_ERROR：其他原因； REGISTER_TIMEOUT：报备超时； NO_SEND_RECORD：签名超过 6 个月无发送记录； EXT_CODE_RECYCLE：扩展码收回。	REGISTER_TIMEOUT
ReasonDescList	array	原因说明列表。可能返回 0 个或者多个原因说明，返回原因码不一定会返回原因说明。
	string	原因说明。	报备超时。

示例

正常返回示例

JSON格式

{
  "RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990",
  "Code": "OK",
  "Message": "OK",
  "SignName": "登录验证",
  "SignStatus": 2,
  "CreateDate": "2024-06-03 10:02:34",
  "OrderId": "20044156924",
  "QualificationId": 0,
  "Remark": "登录场景验证码",
  "AuditInfo": {
    "RejectInfo": "通过资质信息，不能判断是否可以申请此签名。",
    "AuditDate": "2024-06-03 12:02:34\n"
  },
  "FileUrlList": [
    "10098689758*****/1234qwe.png\n"
  ],
  "SignCode": "SIGN_100000077042023_17174665*****_ZM2kG",
  "SignTag": "2",
  "ApplyScene": "http://www.aliyun.com/\n",
  "ThirdParty": false,
  "SignUsage": "已注册商标名称。",
  "RegisterResult": 1,
  "AuthorizationLetterId": 0,
  "AuthorizationLetterAuditPass": true,
  "SignIspRegisterDetailList": [
    {
      "RegisterStatus": 0,
      "OperatorCode": "telecom",
      "OperatorCompleteTime": "2025-06-13 15:55:26",
      "RegisterStatusReasons": [
        {
          "ReasonCode": "REGISTER_TIMEOUT",
          "ReasonDescList": [
            "报备超时。"
          ]
        }
      ]
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	ForbiddenAction	Access to the account is denied. Please contact the administrator.
404	SignatureNotFound	The signature does not exist.	该账号下找不到对应签名。

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

变更历史

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