GetSmsSign - 查询签名详情(新接口)

更新时间:2025-03-26 03:55:23

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

接口说明

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
名称类型必填描述示例值
SignNamestring

签名名称。必须是本账号已申请的短信签名。

阿里云

返回参数

名称类型描述示例值
名称类型描述示例值
object
RequestIdstring

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

F655A8D5-B967-440B-8683-DAD6FF8DE990
Codestring

请求状态码。取值:

  • OK:代表请求成功。
  • 其他错误码,请参见 API 错误码
OK
Messagestring

状态码的描述。

OK
SignNamestring

短信签名名称。

登录验证
SignStatuslong

签名审核状态。取值:

  • 0:审核中。
  • 1:审核通过。
  • 2:审核失败,请在返回参数AuditInfo.RejectInfo中查看审核失败原因。
  • 10:取消审核。
2
CreateDatestring

短信签名的创建日期和时间。

2024-06-03 10:02:34
OrderIdstring

工单号。

审核人员查询审核时会用到此参数。您需要审核加急时需要提供此工单号。

20044156924
QualificationIdlong

资质 ID,申请签名时关联的资质 ID。

2004393****
Remarkstring

短信签名场景说明,长度不超过 200 个字符。

登录场景验证码
AuditInfoobject

审核信息。

RejectInfostring

审批未通过的原因。

通过资质信息,不能判断是否可以申请此签名。
AuditDatestring

审核时间。

2024-06-03 12:02:34
FileUrlListarray

更多资料信息,补充上传业务证明文件或业务截图文件列表。

FileUrlstring

上传到 OSS 上的文件信息。

10098689758*****/1234qwe.png
SignCodestring

短信签名 Code。

SIGN_100000077042023_17174665*****_ZM2kG
SignTagstring

签名标识。取值:

  • 2:用户自定义创建签名。
  • 3:系统赠送签名。
  • 4:测试签名。
  • 5:试用签名。
2
ApplyScenestring

应用场景内容。

http://www.aliyun.com/
ThirdPartyboolean

签名为自用或他用。

  • false:自用(默认值)。

  • true:他用。

false
SignUsagestring

签名使用场景。

已注册商标名称。
RegisterResultinteger

签名实名制报备结果。取值:

  • 0:报备失败,原因可能为资质信息与工信注册信息不一致或运营商侧无法支持等。建议您登录短信服务控制台查看具体失败原因,并依据提示进行操作。
  • 1:报备成功,当前至少有一个子端口号运营商已返回报备通过。建议您少量多次尝试使用该签名发送,观察短信发送效果后再开始批量发送。
  • 2:报备失效,签名超过 6 个月无发送记录时,报备结果失效。如您需要重新启用该签名,请在短信服务控制台重新发起报备。
  • -1:无状态,此结果表明您的签名处于报备流程中或未报备,建议您登录短信服务控制台查看报备详情,如已处于报备流程中请耐心等待;如未报备请检查签名绑定的资质是否需要更新,检查无误后重新发起报备。

建议您单击查看更多签名实名制报备内容及建议操作

1

示例

正常返回示例

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
}

错误码

HTTP status code错误码错误信息描述
HTTP status code错误码错误信息描述
400ForbiddenActionAccess to the account is denied. Please contact the administrator.没有访问权限,请联系管理员
404SignatureNotFoundThe signature does not exist.该账号下找不到对应签名。

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

变更历史

变更时间变更内容概要操作
变更时间变更内容概要操作
2025-01-03OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
  • 本页导读 (1)
  • 接口说明
  • 调试
  • 授权信息
  • 请求参数
  • 返回参数
  • 示例
  • 错误码
  • 变更历史