智能消息素材上传

1、概述

智能消息的素材,需要先上传至平台,保证智能消息模板制作时素材已存在。

2、接口地址

POST https://rcsapi.hanwg.com/aim/material/upload

3、请求参数

3.1、请求路径参数

全局参数

3.2、请求头参数

接口权限校验

3.3、请求体参数

名称 数据类型 是否必有 描述
file binary 素材文件
fileId string 素材编号
字母+数字,可自定义,未定义时汉武际平台默认生成UUID,生成的编号会返回响应
type int 文件类别
  • 1:图片(最大2M,支持jpeg、jpg、png)
  • 2:视频(最大10M,支持mp4)
  • 3:缩略图(最大100k,支持jpeg、jpg、png)
  • 4、请求示例

    POST /aim/material/upload HTTP/1.1
    Content-Type: multipart/form-data; boundary=--------------------------316708790964520085153438
    Accept: application/json
    Authorization: ZGgxODUyODo2NjhlZjA4Y2NkOTUxNWMzYzMyNjIwNTgzOGNjMDY1NQ==
    Date: 2023-02-16 14:51:31
    User-Agent: PostmanRuntime/7.31.0
    Postman-Token: 4be4c91d-eedb-4e75-9e50-aeea5d1d1f8d
    Host: 172.18.1.104:31205
    Accept-Encoding: gzip, deflate, br
    Connection: keep-alive
    Content-Length: 290103
    
    ----------------------------316708790964520085153438
    Content-Disposition: form-data; name="file"; filename="年节甄选.png"; filename*="UTF-8''%E5%B9%B4%E8%8A%82%E7%94%84%E9%80%89.png"
    <年节甄选.png>
    ----------------------------316708790964520085153438--


    示例结果

    5、响应参数

    名称 数据类型 是否必有 描述
    code int 响应状态码
    desc string 响应描述
    result object 条件 响应内容
    需要:code = 0(请求成功)
    materialId string 素材编号
    与请求时的fileId一致
    time date 上传完成的时间
    格式:yyyy-MM-dd HH:mm:ss

    6、响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json
    Transfer-Encoding: chunked
    Date: Thu, 16 Feb 2023 06:51:30 GMT
    Connection: close
    
    {
      "code": 0,
      "desc": "请求成功",
      "result": {
        "materialId": "b57f262c05fe4f7aafec8bda4ddba2c3",
        "time": "2023-02-16 06:51:30"
      }
    }
    文档更新时间: 2026-05-15 14:31   作者:王超