注册送短信

API: rcs/media - 创建素材


概览


rcs/upload 是 SUBMAIL 5G消息的素材创建 API。



URL


https://api-v4.mysubmail.com/rcs/media


接口响应数据格式


格式URL
jsonhttps://api-v4.mysubmail.com/rcs/media.json(默认)
xmlhttps://api-v4.mysubmail.com/rcs/media.xml
yamlhttps://api-v4.mysubmail.com/rcs/media.yaml


http 请求方式


请求方式content-type设置
postmultipart/form-data




请求参数


参数类型必需/可选默认描述
appidstring必须在 SUBMAIL Chatbot中创建的5G消息应用ID
filefile必须素材文件 素材大小建议控制在2M内
timestampint可选UNIX 时间戳,结果以秒为单位,使用加密鉴权方式,此参数必填
signTypestring可选normalAPI 鉴权模式,可选参数normalsha256
signaturestring必须鉴权签名
1. 当signTypesha256时,将以下参数拼接
appid+appkey+appid=?&signType=sha256& timestamp=1712122221+appid+appkey
“+”号为链接符号,不参与拼接
用sha256将以上拼接字符串加密作为鉴权参数
signTypenormal时,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":"错误信息描述"
}