头像上传
查看文档来源信息
- 来源目录：
addons/sys_base/docs - 来源文件：
接口文档/15-头像上传.md
详细说明
用于完成“头像上传”相关的正式链路操作。
接口信息
| 项目 | 内容 |
|---|---|
| 请求方式 | POST |
| 请求路径 | /sys_base/platform/fileUploadAndDownload/headerUploadFile |
| 来源文件 | 接口文档/15-头像上传.md |
请求头
| 请求头 | 示例值 | 说明 |
|---|---|---|
x-token | <登录令牌> | 登录令牌。 |
app-id | mid-admin | 当前应用 ID。 |
addons-type | sys_base | 当前模块标识。 |
入参
| 参数名 | 类型 | 是否必填 | 示例值 | 参数说明 |
|---|---|---|---|---|
file | file | 是 | avatar.png | 头像文件 |
参数说明
file：头像文件。
请求示例
json
{
"file": "avatar.png"
}响应输出
json
{
"code": 1000,
"msg": "上传成功",
"data": {
"id": 3001,
"name": "avatar.png",
"url": "https://example.com/files/avatar.png"
}
}字段说明
| 字段名 | 类型 | 示例值 | 字段说明 |
|---|---|---|---|
code | number | 1000 | 业务状态码 |
msg | string | 操作成功 | 返回消息 |
data.id | number | 3001 | 文件 ID |
data.name | string | avatar.png | 文件名称 |
data.url | string | https://example.com/files/avatar.png | 文件地址 |
curl 示例
bash
curl --location --request POST 'http://127.0.0.1:8100/sys_base/platform/fileUploadAndDownload/headerUploadFile' \
--header 'x-token: <登录令牌>' \
--header 'app-id: mid-admin' \
--header 'addons-type: sys_base' \
--form 'file=@"avatar.png"'