云消息服务 KOOMESSAGE-上传智能信息模板素材:请求参数

时间:2025-01-06 16:13:33

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

请求体参数类型,该字段必须设置为:application/json。

X-Auth-Token

String

用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表2 请求Body参数

参数

是否必选

参数类型

描述

resource_type

String

资源类型。

  • image:图片

  • video:视频

  • thumbnail:缩略图

说明:

图片支持png、jpeg、jpg格式,最大2M;

视频支持格式mp4,大小不超过7M,建议时长不超过33S;

缩略图支持png、jpeg、jpg格式,大小不超过100K。

最小长度:1

最大长度:16

material_id

String

素材ID。

说明:

resource_type=thumbnail时,material_id必填,填写内容为上传视频资源返回的material_id字段的值。

最小长度:0

最大长度:36

file_type

String

文件类型。

  • url:资源为URL链接地址

  • stream:资源为多媒体资源文件流的BASE64编码,需要带资源类型前缀,样例:"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gIoSUNDX1BST0ZJTEUAAQEAAAIYAAAAAAQwAABtbnRyUkdCIFhZWiAAAAAAAAAAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQ...",样例过长,未显示全部。

最小长度:1

最大长度:16

file_url

String

文件URL。

说明:

file_type=url时,file_url为必填。URL地址必须包含文件格式的后缀,例如:jpg、jpeg,大小写后缀都支持。

最大长度:1000

file_stream

String

文件资源码流。

说明:

file_type=stream时,file_stream为必填。

image_rate

String

图像比例。

  • oneToOne:指1:1比例

  • sixteenToNine:指16:9比例

  • threeToOne:指3:1比例

  • fortyEightToSixtyFive:指48:65比例

  • twentyOneToNine:指21:9比例

  • threeToFour:指3:4比例

说明:

resource type=image时,image_rate必填。

最大长度:32

file_name

String

文件名称。

说明:

file_type=stream时,file_name必填。

最大长度:200

description

String

描述。

最大长度:50

support.huaweicloud.com/api-koomessage/UploadTemplateMaterial.html