5G消息素材上传

1、概述

素材：消息发送时消息携带的图片、视频、音频、文件类型这四种多媒体文件。5G消息携带的素材需要先进行上传，经运营平台审核通过后才能被发送。

素材 模板
需要审核 是 是
需要报备 是 否

缩略图：素材的封面图片。缩略图会与素材绑定，发送5G消息时只需设置素材id参数，即自动携带与之绑定的缩略图。

 图片 视频，音频
带有缩略图 终端手机展示此图片 终端手机展示缩略图
不带缩略图 终端手机展示此图片 终端手机展示手机自己对于音频视频处理的图片

2、接口地址

POST https://rcsapi.hanwg.com/rcs/medias/upload/{{chatbotId}}

3、请求参数

3.1、请求路径参数

见全局参数

3.2、请求头参数

见接口权限校验

3.3、请求体参数

名称 数据类型 是否必有 描述
file binary 是 素材文件
1. 图片：最大20MB，支持jpeg、jpg、png、gif、bmp
2. 音频：最大20MB，支持mp4、3gp
3. 视频：最大20MB，支持mp3、m4a、aac、amr
4. 文档：最大20MB，支持vcf
thumbnail binary 否 缩略图/封面
最大10K，支持jpg、jpeg、png、bmp
fileId string 否 素材编号
1. 在同一个chatbot下不能重复，可自定义，未定义时汉武际平台默认生成UUID，生成的编号会返回响应
2. 只能由汉字、英文字母、数字、’_’和’-‘组成
keyword string 否 关键字标签
1. 由英文逗号“,”分隔开不同的关键字
2. 只能由汉字、英文字母、数字组成
3. 每个关键字长度不超过10个字符， 每个文件最多有10个关键字
mode string 否 上传素材类型
  • perm：永久素材
  • temp：临时素材（默认）
    		•

    4、请求示例

    POST /rcs/medias/upload/a92e43085a0049ba8928b61fa04eeee HTTP/1.1
Date: 2023-02-16 14:17:24
Authorization: ZGgxODUyODplZTFmMTMzY2E5NzBiYjZkZDg2MzBkZGVhMmY3NDY5NA==
User-Agent: PostmanRuntime/7.31.0
Accept: */*
Postman-Token: 93d280ec-f641-4669-8ecd-09776d5b3912
Host: 172.18.1.104:31205
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Type: multipart/form-data; boundary=--------------------------075626878106357507764441
Content-Length: 355079

----------------------------075626878106357507764441
Content-Disposition: form-data; name="file"; filename="幻得幻失.png"; filename*="UTF-8''%E5%B9%BB%E5%BE%97%E5%B9%BB%E5%A4%B1.png"
<幻得幻失.png>
----------------------------075626878106357507764441
Content-Disposition: form-data; name="fileId"
material_001
----------------------------075626878106357507764441
Content-Disposition: form-data; name="thumbnail"; filename="地球.jpg"; filename*="UTF-8''%E5%9C%B0%E7%90%83.jpg"
<地球.jpg>
----------------------------075626878106357507764441
Content-Disposition: form-data; name="keyword"
海洋,树林
----------------------------075626878106357507764441
Content-Disposition: form-data; name="mode"
temp
----------------------------075626878106357507764441--


    示例结果

    5、响应参数

    字段 数据类型 是否必有 描述
    code int 是 响应状态码
    desc string 是 请求响应描述
    result object 条件 请求响应内容
    需要：code = 0（请求成功）
    fileId string 是 素材编号（素材在平台的唯一标识）
    filePath string 是 素材路径
    thumbnailPath string 是 缩略图路径
    until date 是 有效期
    时间格式：yyyy-MM-dd HH:mm:ss
    keyword string 是 关键字内容

    6、响应示例

    HTTP/1.1 200 OK
Content-Type: application/json
Transfer-Encoding: chunked
Date: Thu, 16 Feb 2023 06:17:23 GMT
Connection: close

{
  "code": 0,
  "desc": "请求成功",
  "result": {
    "fileId": "material_001",
    "filePath": "rcs/20230216141723/file/be1b2c601fb348f2b9bc4e81a4845c.png",
    "thumbnailPath": "rcs/20230216141723/thumbnail/c4fb609198db412db7114bd4fc383d.jpg",
    "until": "2023-03-18 14:17:23",
    "keyword": "海洋,树林"
  }
}
    文档更新时间: 2025-12-17 09:32   作者：王超