API: rcs/media - 创建素材
概览
rcs/upload 是 SUBMAIL 5G消息的素材创建 API。
URL
https://api-v4.mysubmail.com/rcs/media
接口响应数据格式
| 格式 | URL |
|---|---|
json | https://api-v4.mysubmail.com/rcs/media.json（默认） |
xml | https://api-v4.mysubmail.com/rcs/media.xml |
yaml | https://api-v4.mysubmail.com/rcs/media.yaml |
http 请求方式
| 请求方式 | content-type设置 |
|---|---|
post | multipart/form-data |
请求参数
| 参数 | 类型 | 必需/可选 | 默认 | 描述 |
|---|---|---|---|---|
appid | string | 必须 | 无 | 在 SUBMAIL Chatbot中创建的5G消息应用ID |
file | file | 必须 | 无 | 素材文件 素材大小建议控制在2M内 |
timestamp | int | 可选 | 无 | UNIX 时间戳，结果以秒为单位，使用加密鉴权方式，此参数必填 |
signType | string | 可选 | normal | API 鉴权模式，可选参数normal、sha256 |
signature | string | 必须 | 无 | 鉴权签名 1. 当 signType为sha256时，将以下参数拼接appid+appkey+appid=?&signType=sha256& timestamp=1712122221+appid+appkey“+”号为链接符号，不参与拼接 用sha256将以上拼接字符串加密作为鉴权参数 当 signType为normal时，appkey即是signature的值 |
请求示例
POST /rcs/media HTTP/1.1
Host: api-v4.mysubmail.com
Content-Length: 370
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="appid"
appid
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="signature"
signature
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="123.png"
Content-Type: image/png
(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW--成功返回
{
"status": "success",
"id": "ikJvMC", //素材ID
}失败返回
{
"status":"error",
"code":"2xxx",
"msg":"错误信息描述"
}