GetRCSSignature - 查询5G短信签名详情

更新时间:
复制 MD 格式

查询5G消息签名的详细信息。

接口说明

前提条件

已通过 UpgradeToRCSSignature 接口将文本短信签名升级为 5G 消息签名。

使用说明

通过签名名称查询签名的完整信息,包括 Chatbot 信息、服务信息、报备结果和上架结果。

QPS 限制

本接口的单用户 QPS 限制为 50 次/秒。超过限制,API 调用将会被限流,这可能会影响您的业务,请合理调用。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

SignName

string

5G 消息签名名称。

阿里云

返回参数

名称

类型

描述

示例值

object

AccessDeniedDetail

string

访问被拒绝时返回的详细信息。

None

RequestId

string

本次请求的 ID。

A90E4451-FED7-49D2-87C8-00700A8C4D0D

Message

string

状态码的描述。

OK

Data

object

返回数据。

ChatbotName

string

Chatbot 名称。

阿里云

SignId

integer

签名唯一标识。

100000

Category

integer

行业类型编号。

9

Description

string

描述信息。

Aliyun official Chatbot

ServiceEmail

string

服务邮箱。

service@example.com

ChatbotCode

string

Chatbot 唯一标识。

RCS_CHATBOT_123410123

Latitude

string

地址位置纬度。数字格式,小数点后最多 3 位。

30.000

RegisterResultList

array<object>

报备结果列表。

array<object>

报备结果。

RegisterStatus

integer

报备状态。取值:

  • 1:报备中。

  • 2:报备失败。

  • 3:报备成功。

3

ProductType

integer

产品类型。

1

OperatorCode

string

运营商编码。

mobile

RegisterStatusReasons

array<object>

报备状态原因列表。

object

报备状态原因。

ReasonDescList

array

原因说明列表。

string

原因说明。

其他原因报备失败

ReasonCode

string

报备状态原因码。

1001

RegisterCompleteTime

string

报备完成时间。

2026-04-01 00:00:00

OfficeAddress

string

办公地址。

No.XX, XX Road, Xihu District, Hangzhou

ServiceTerms

string

服务条款 URL。

https://www.example.com/terms

Longitude

string

地址位置经度。数字格式,小数点后最多 3 位。

120.000

SignName

string

签名名称。

阿里云

ServicePhone

string

服务电话。

400-800-****

BackgroundImage

string

背景图片的 fileKey。

China_regions****/background.png

ServiceWebsite

string

服务官网 URL。

https://www.example.com

BubbleColor

string

气泡颜色。格式为#rrggbb。

#FF0000

ShelfResultList

array<object>

上架结果列表。

array<object>

上架结果数据对象。

ShelfStatus

integer

上架状态。取值:

  • 1:上架中。

  • 2:上架成功。

  • 3:上架失败。

2

ShelfStatusReasons

array<object>

上架状态原因列表。

object

上架状态原因。

ReasonDescList

array

原因说明列表。

string

原因说明。

其他原因报备失败

ReasonCode

string

上架状态原因码。

1001

ProductType

integer

产品类型。

1

OperatorCode

string

运营商编码。

mobile

Code

string

请求状态码。返回 OK 代表请求成功。

OK

Success

boolean

是否调用成功。

  • true:调用成功。

  • false:调用失败。

true

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": "None",
  "RequestId": "A90E4451-FED7-49D2-87C8-00700A8C4D0D",
  "Message": "OK",
  "Data": {
    "ChatbotName": "阿里云",
    "SignId": 100000,
    "Category": 9,
    "Description": "Aliyun official Chatbot",
    "ServiceEmail": "service@example.com",
    "ChatbotCode": "RCS_CHATBOT_123410123",
    "Latitude": "30.000",
    "RegisterResultList": [
      {
        "RegisterStatus": 3,
        "ProductType": 1,
        "OperatorCode": "mobile",
        "RegisterStatusReasons": [
          {
            "ReasonDescList": [
              "其他原因报备失败"
            ],
            "ReasonCode": "1001"
          }
        ],
        "RegisterCompleteTime": "2026-04-01 00:00:00"
      }
    ],
    "OfficeAddress": "No.XX, XX Road, Xihu District, Hangzhou",
    "ServiceTerms": "https://www.example.com/terms",
    "Longitude": "120.000",
    "SignName": "阿里云",
    "Logo": "China_regions****/logo.png",
    "ServicePhone": "400-800-****",
    "BackgroundImage": "China_regions****/background.png",
    "ServiceWebsite": "https://www.example.com",
    "BubbleColor": "#FF0000",
    "ShelfResultList": [
      {
        "ShelfStatus": 2,
        "ShelfStatusReasons": [
          {
            "ReasonDescList": [
              "其他原因报备失败"
            ],
            "ReasonCode": "1001"
          }
        ],
        "ProductType": 1,
        "OperatorCode": "mobile"
      }
    ]
  },
  "Code": "OK",
  "Success": true
}

错误码

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

变更历史

更多信息,参考变更详情