上传媒体文件
以 base64 方式上传图片，返回平台图片地址，可用于 修改营种信息 的封面图等场景。适用于已开通该场景的对接；未使用该场景时可忽略。
信息
仅支持图片。建议传入带前缀的完整数据流，如 data:image/jpeg;base64, + 图片 base64 内容；未带前缀时按 jpg 处理。
POST/api/upLoadMedia
请求参数
| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| token | String | 身份校验令牌 | 必填 | - | 由 获取访问令牌 获得 |
| base64 | String | 图片 base64 数据流 | 必填 | - | 可带 data:image/jpeg;base64, 前缀 |
CURL
curl --location --request POST 'https://open.xinduobang.cn/api/upLoadMedia' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'base64=data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...'
成功响应
{
"code": 0,
"data": {
"url": "https://file.dev.xinduobang.cn/open/abeddc4f804c2908e90dd0edb51bd83f.jpg"
}
}
| 字段 | 类型 | 说明 |
|---|---|---|
| data.url | String | 图片地址，可直接引用 |
失败响应
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 4001 | 图片不能为空 | 确认已传 base64 |
| 200 | 4001 | 图片格式不正确 | 数据需为 data:image/<格式>;base64, 开头的图片 |
| 200 | 非 0 | 业务错误 | 未开通该场景时返回暂无权限；其余请检查 token |
相关接口
- 修改营种信息：
修改营种信息