API: aim/upload - 上传素材
概览
aim/upload 是 SUBMAIL AIM阅信的素材上传 API。
URL
https://api-v4.mysubmail.com/aim/upload
接口响应数据格式
| 格式 | URL |
|---|---|
json | https://api-v4.mysubmail.com/aim/upload.json（默认） |
http 请求方式
| 请求方式 | content-type设置 |
|---|---|
post | multipart/form-data、x-www-form-urlencoded、application/json |
是否需要授权
是
参阅 API 授权和验证机制
请求参数
| 参数 | 类型 | 必需/可选 | 默认 | 描述 |
|---|---|---|---|---|
appid | string | 必需 | 无 | 在 SUBMAIL 应用集成中创建的短信应用ID |
uploadType | int | 可选 | 0 | 0为通过文件上传，1为通过base64编码上上传 |
file | file | 条件可选 | 无 | uploadType参数为0时，该参数必填。<br/>素材文件，可支持的格式为：图片：（jpg、jpeg、png）最大不超过20M 视频：mp4，视频最大不超过10M *图片素材大小建议控制在2M内，否则影响用户侧解析时间和解析效果* |
contentType | string | 条件可选 | 无 | uploadType参数为1时，该参数必填。<br/>文件扩展类型。可选值：jpg、jpeg、png、mp4 |
fileData | string | 条件可选 | 无 | upload_type参数为1时，该参数必填。<br/>素材文件，可支持的格式为：<br/>图片：（jpg、jpeg、png）最大不超过20M<br/>视频：mp4，视频最大不超过10M<br/> *图片素材大小建议控制在2M内，否则影响用户侧解析时间和解析效果* |
fileRate | int | 可选 | 0 | 当上传的素材为图片时，该参数有效，参数可选值：<br/>0. 图片长宽比为1:1<br/>1. 图片长宽比为16:9<br/>2. 图片长宽比为3:1<br/>3. 图片长宽比为48:65<br/>*请自行调整好图片的长宽比后上传* |
timestamp | int | 可选 | 无 | UNIX 时间戳，参阅 API 授权与验证机制 > timestamp |
signType | string | 可选 | normal | API 授权模式（ md5 or sha1 or normal ）参阅 API 授权与验证机制 > 授权和验证方式 |
signature | string | 必需 | 无 | 应用密匙或数字签名 参阅 API授权与验证机制 > 授权和验证方式。当sign_type=normal时signature应传appkey的值。 |
代码示例
发送一封测试短信
POST URL
https://api-v4.mysubmail.com/aim/uploadPOST DATA
{
"appid":"your_app_id",
"signature":"your_app_key",
"contentType":"png",
"fileData":"/9j/4QAYRXhpZgAASUkqAAgAAAAAAAAAAAAAAP/sABFEdWNr………………",
"fileRate":0
}成功返回
{
"status": "success", //请求状态
"id": "ikJvMC", //素材ID
}失败返回
{
"status":"error", //请求状态
"code":"1xx", //失败码
"msg":"error sms" //失败信息描述
}