单个查询5G消息素材详情
接口说明
前提条件
已通过 CreateRCSAsset 接口上传 5G 消息素材。
使用说明
返回素材基础信息，包括文件类型、文件大小、下载 URL 和过期状态，其中文件大小单位为 kB。
返回按运营商和产品类型聚合的审核状态列表，仅审核失败时返回审核异常信息。
素材文件和缩略图的下载 URL 带签名和有效期，请及时使用。
错误码
调用失败时 Success 返回 false，Code 返回对应错误码：
ILLEGAL_PARAM：参数校验失败，Message 中返回具体校验错误信息。
ASSET_NOT_FOUND：素材不存在。
SYSTEM_ERROR：系统异常。
QPS 限制
本接口的单用户 QPS 限制为 50 次/秒。超过限制，API 调用将会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SignName |
string |
是 |
签名名称。非空，最长 128 字符。 |
阿里云 |
| AssetCode |
string |
是 |
素材编码。非空，最长 64 字符。通过 CreateRCSAsset 接口创建素材时返回。 |
ASSET_1721932656000a1b2c3 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
访问被拒绝时返回的详细信息。 |
None |
| RequestId |
string |
本次请求的 ID。 |
A90E4451-FED7-49D2-87C8-00700A8C4D0D |
| Message |
string |
状态码的描述。 |
OK |
| Data |
object |
返回数据。 |
|
| AssetFileSize |
integer |
素材文件大小，单位为 kB。 |
1024 |
| ThumbnailFileUrl |
string |
缩略图文件可下载的 OSS URL，带签名和有效期。 |
https://oss.example.com/thumb.jpg |
| ExpireStatus |
integer |
过期状态。取值：
|
0 |
| AssetFileType |
integer |
素材文件类型。取值：
|
1 |
| AssetFileUrl |
string |
素材文件可下载的 OSS URL，带签名和有效期。 |
https://oss.example.com/asset.jpg |
| AssetCode |
string |
素材编码。 |
ASSET_1721932656000a1b2c3 |
| AuditStatusList |
array<object> |
按运营商和产品类型聚合的审核状态列表。 |
|
|
array<object> |
|||
| BizProductType |
integer |
产品类型。取值：
|
10 |
| AuditStatus |
integer |
聚合审核状态。取值：
|
1 |
| AuditFailInfo |
object |
审核异常信息，仅 auditStatus 为 2 时有值。 |
|
| AssetFileAuditFailReason |
string |
素材文件审核异常信息。 |
图片分辨率过低 |
| ThumbnailFileAuditFailReason |
string |
缩略图文件审核异常信息。 |
缩略图格式不支持 |
| Carrier |
integer |
运营商。取值：
|
1 |
| Code |
string |
请求状态码。返回 OK 代表请求成功。 |
OK |
| Success |
boolean |
是否调用成功。
|
true |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "None",
"RequestId": "A90E4451-FED7-49D2-87C8-00700A8C4D0D",
"Message": "OK",
"Data": {
"AssetFileSize": 1024,
"ThumbnailFileUrl": "https://oss.example.com/thumb.jpg",
"ExpireStatus": 0,
"AssetFileType": 1,
"AssetFileUrl": "https://oss.example.com/asset.jpg",
"AssetCode": "ASSET_1721932656000a1b2c3",
"AuditStatusList": [
{
"BizProductType": 10,
"AuditStatus": 1,
"AuditFailInfo": {
"AssetFileAuditFailReason": "图片分辨率过低",
"ThumbnailFileAuditFailReason": "缩略图格式不支持"
},
"Carrier": 1
}
]
},
"Code": "OK",
"Success": true
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。